tavily-search MCP 服务器

这是一个MCP服务器项目

组件

此服务器使用Tavily API根据指定的查询执行搜索。

• 搜索结果以文本格式返回。
• 搜索结果包括AI响应、URI和搜索结果的标题。

工具

此服务器实现了以下工具：

• search: 根据指定的查询执行搜索
  • 必需参数: "query"
  • 可选参数: "search_depth" (基础或高级)

通过Smithery安装

要通过Smithery自动为Claude Desktop安装Tavily Search：

npx -y @smithery/cli install tavily-search --client claude

安装

1. 下载仓库。

git clone https://github.com/Tomatio13/mcp-server-tavily.git

1. 打开Claude Desktop配置文件。

On MacOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
On Windows: `C:\Users\[username]\AppData\Roaming\Claude\claude_desktop_config.json`

1. 按如下方式编辑配置文件：

"mcpServers": {
  "tavily-search": {
    "command": "uv",
    "args": [
      "--directory",
      "C:\\your_path\\mcp-server-tavily",
      "run",
      "tavily-search"
    ],
    "env": {
      "TAVILY_API_KEY": "YOUR_TAVILY_API_KEY",
      "PYTHONIOENCODING": "utf-8"
    }
  }
}

1. 重启Claude Desktop。

使用方法

在Claude Desktop中，当你请求“请搜索某物”时，你将收到搜索结果。

搜索示例：

Please search in detail for today's events in Kamakura

响应示例：

According to the search results, the following events start today, December 1st:
"Kamakura Promotion Photo Contest 2025"
Period: December 1, 2024 - January 31, 2025
A photo contest for those who love Kamakura
Applications start accepting from today
Also, as a related upcoming event:
On December 7th, an exhibition by 12 Kamakura artists will be held at the Seibu Press Inn Kamakura Ofuna Station East Exit Lounge.

日志存储位置

日志存储在以下位置：

对于Windows：

C:\Users\[username]\AppData\Roaming\Claude\logs\mcp-server-tavily-search

通过Cursor执行

1. 创建一个shell脚本（例如script.sh），如下所示：

#!/bin/bash
TARGET_DIR=/path/to/mcp-server-tavily
cd "${TARGET_DIR}"
export TAVILY_API_KEY="your-api-key"
export PYTHONIOENCODING=utf-8
uv --directory $PWD run tavily-search

1. 按如下方式配置Cursor的MCP服务器设置：

Name: tavily-search
Type: command
Command: /path/to/your/script.sh

1. 保存设置。

2. 一旦设置保存后，你可以要求Cursor的Composer-Agent“搜索某物”，它将返回搜索结果。

使用Docker Compose在本地环境运行

目的

对于不能使用Claude Desktop的非Windows/MacOS操作系统，
本节解释了如何使用Docker compose在本地环境中设置和运行MCP服务器和客户端。

步骤

1. 安装Docker。
2. 下载仓库。

git clone https://github.com/Tomatio13/mcp-server-tavily.git

1. 运行Docker compose。

docker compose up -d

1. 执行客户端。

docker exec mcp_server uv --directory /usr/src/app/mcp-server-tavily/src run client.py

1. 执行结果
2. 如下所示搜索可用工具后，将向Tavily发出查询并返回响应：

2024-12-01 11:21:56,930 - tavily-search-server - INFO - Starting Tavily search server
2024-12-01 11:21:56,932 - tavily-search-server - INFO - Server initialized, starting main loop
2024-12-01 11:21:56,936 - mcp.server - INFO - Processing request of type ListToolsRequest
2024-12-01 11:21:56,936 - tavily-search-server - INFO - Listing available tools
利用可能なツール: nextCursor=None tools=[Tool(name='search', description='Search the web using Tavily API', inputSchema={'type': 'object', 'properties': {'query': {'type': 'string', 'description': 'Search query'}, 'search_depth': {'type': 'string', 'description': 'Search depth (basic or advanced)', 'enum': ['basic', 'advanced']}}, 'required': ['query']})]
2024-12-01 11:21:56,937 - mcp.server - INFO - Processing request of type CallToolRequest
2024-12-01 11:21:56,937 - tavily-search-server - INFO - TOOL_CALL_DEBUG: Tool called - name: search, arguments: {'query': '今日の東京タワーのイベントを教えて下さい'}
2024-12-01 11:21:56,937 - tavily-search-server - INFO - Executing search with query: '今日の東京タワーのイベントを教えて下さい'
2024-12-01 11:22:00,243 - httpx - INFO - HTTP Request: POST https://api.tavily.com/search "HTTP/1.1 200 OK"
2024-12-01 11:22:00,243 - tavily-search-server - INFO - Search successful - Answer generated
2024-12-01 11:22:00,243 - tavily-search-server - INFO - Search successful - Results available
ツール実行結果: content=[TextContent(type='text', text='AI Answer:\n今日の東京タワーのイベントは以下の通りです：\n1. Candlelight: エド・シーランとコールドプレイのヒットメドレー - 12月01日\n2. チームラボプラネッツ TOKYO - 12月01日から1月21日\n\n他にもイベントがある可能性がありますので、公式ウェブサイト等で最新情報をご確認ください。\n\n\n\nSearch Results:\n\n1. 東京タワー (東京): 現在のイベントとチケット | Fever\nURL: https://feverup.com/ja/tokyo/venue/tokyo-tower\nSummary: Summary not found\n\n\n2. 東京タワー(東京都)の施設で開催するイベント一覧｜ウォーカープラス\nURL: https://www.walkerplus.com/spot/ar0313s03867/e_list.html\nSummary: Summary not found\n\n\n3. 東京タワー - Tokyo Tower\nURL: https://www.tokyotower.co.jp/event/\nSummary: Summary not found\n')] isError=False