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

2. 打开Claude Desktop配置文件。

MacOS系统：`~/Library/Application\ Support/Claude/claude_desktop_config.json`
Windows系统：`C:\Users\[用户名]\AppData\Roaming\Claude\claude_desktop_config.json`

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

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

4. 重启Claude Desktop。

使用方法

在Claude Desktop中，当你询问"请搜索某内容"时，你将收到搜索结果。

搜索示例：

请详细搜索今天镰仓的活动

响应示例：

根据搜索结果，以下活动于今天12月1日开始：
"镰仓推广摄影比赛2025"
时间：2024年12月1日 - 2025年1月31日
为热爱镰仓的人举办的摄影比赛
申请从今天开始接受
另外，作为相关即将举行的活动：
12月7日，12位镰仓艺术家将在西武Press Inn镰仓大船站东口休息室举办展览。

日志存储位置

日志存储在以下位置：

Windows系统：

C:\Users\[用户名]\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="你的api-key"
export PYTHONIOENCODING=utf-8
uv --directory $PWD run tavily-search

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

名称：tavily-search
类型：命令
命令：/path/to/your/script.sh

3. 保存设置。

4. 设置保存后，你可以让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

3. 运行Docker compose。

docker compose up -d

4. 执行客户端。

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

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

2024-12-01 11:21:56,930 - tavily-search-server - INFO - 启动Tavily搜索服务器
2024-12-01 11:21:56,932 - tavily-search-server - INFO - 服务器初始化，启动主循环
2024-12-01 11:21:56,936 - mcp.server - INFO - 处理类型为ListToolsRequest的请求
2024-12-01 11:21:56,936 - tavily-search-server - INFO - 列出可用工具
可用工具: nextCursor=None tools=[Tool(name='search', description='使用Tavily API搜索网络', inputSchema={'type': 'object', 'properties': {'query': {'type': 'string', 'description': '搜索查询'}, 'search_depth': {'type': 'string', 'description': '搜索深度（基础或高级）', 'enum': ['basic', 'advanced']}}, 'required': ['query']})]
2024-12-01 11:21:56,937 - mcp.server - INFO - 处理类型为CallToolRequest的请求
2024-12-01 11:21:56,937 - tavily-search-server - INFO - TOOL_CALL_DEBUG: 调用工具 - 名称：search，参数：{'query': '请告诉我今天东京塔的活动'}
2024-12-01 11:21:56,937 - tavily-search-server - INFO - 使用查询'请告诉我今天东京塔的活动'执行搜索
2024-12-01 11:22:00,243 - httpx - INFO - HTTP请求：POST https://api.tavily.com/search "HTTP/1.1 200 OK"
2024-12-01 11:22:00,243 - tavily-search-server - INFO - 搜索成功 - 生成回答
2024-12-01 11:22:00,243 - tavily-search-server - INFO - 搜索成功 - 结果可用
工具执行结果：content=[TextContent(type='text', text='AI回答：
今天东京塔的活动如下：
1. 烛光：Ed Sheeran和Coldplay的热门歌曲串烧 - 12月01日
2. teamLab Planets TOKYO - 12月01日至1月21日

可能还有其他活动，请查看官方网站等获取最新信息。
 
 

搜索结果：
 
1. 东京塔（东京）：当前活动和门票 | Fever
URL: https://feverup.com/ja/tokyo/venue/tokyo-tower
摘要：未找到摘要
 
 
2. 东京都东京塔设施举办的活动一览｜Walkerplus
URL: https://www.walkerplus.com/spot/ar0313s03867/e_list.html
摘要：未找到摘要
 
 
3. 东京塔 - Tokyo Tower
URL: https://www.tokyotower.co.jp/event/
摘要：未找到摘要
 
')] isError=False