好的,请提供需要翻译的英文技术文档内容,我将严格按照规则返回中文翻译。
概述
tavily-search MCP 服务器
一个 MCP 服务器项目
组件
该服务器使用 Tavily API 根据指定查询执行搜索。
- 搜索结果以文本格式返回。
- 搜索结果包含 AI 响应、URI 和搜索结果的标题。
工具
该服务器实现了以下工具:
- search:根据指定查询执行搜索
- 必选参数:"query"
- 可选参数:"search_depth"(basic 或 advanced)
通过 Smithery 安装
要通过 Smithery 自动为 Claude Desktop 安装 Tavily Search:
bash
npx -y @smithery/cli install tavily-search --client claude
安装
- 下载代码库。
bash
git clone https://github.com/Tomatio13/mcp-server-tavily.git
- 打开 Claude Desktop 配置文件。
在 MacOS 上:`~/Library/Application\ Support/Claude/claude_desktop_config.json`
在 Windows 上:`C:\Users\[username]\AppData\Roaming\Claude\claude_desktop_config.json`
- 按如下方式编辑配置文件:
yaml
"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"
}
}
}
- 重启 Claude Desktop。
使用
在 Claude Desktop 中,当您询问"请搜索某些内容"时,您将收到搜索结果。
搜索示例:
请详细搜索今天镰仓的活动
响应示例:
根据搜索结果,12月1日今天开始有以下活动:
"镰仓宣传照片大赛2025"
期间:2024年12月1日 - 2025年1月31日
面向热爱镰仓人士的照片比赛
今天起开始接受申请
另外,相关即将举办的活动:
12月7日将在西武Press Inn镰仓大船站东出口休息室举办12位镰仓艺术家的展览。
日志存储位置
日志存储在以下位置:
Windows 系统:
C:\Users\[username]\AppData\Roaming\Claude\logs\mcp-server-tavily-search
使用 Cursor 执行
- 创建一个 shell 脚本(如
script.sh),内容如下:
bash
#!/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
- 按如下方式配置 Cursor 的 MCP Server 设置:
名称:tavily-search
类型:command
命令:/path/to/your/script.sh
-
保存设置。
-
设置保存后,您可以要求 Cursor 的 Composer-Agent "搜索某些内容",它将返回搜索结果。
使用 Docker Compose 在本地环境运行
目的
对于无法使用 Claude Desktop 的 Windows/MacOS 以外的操作系统,
本节介绍如何使用 Docker compose 在本地环境中设置和运行 MCP 服务器和客户端。
步骤
- 安装 Docker。
- 下载代码库。
bash
git clone https://github.com/Tomatio13/mcp-server-tavily.git
- 运行 Docker compose。
bash
docker compose up -d
- 执行客户端。
bash
docker exec mcp_server uv --directory /usr/src/app/mcp-server-tavily/src run client.py
- 执行结果
- 如下所示搜索可用工具后,将向 Tavily 发出查询并返回响应:
bash
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': '搜索深度(basic 或 advanced)', '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 回答:\n今天东京塔的活动如下:\n1. Candlelight: Ed Sheeran 和 Coldplay 的热门歌曲串烧 - 12月01日\n2. teamLab Planets TOKYO - 12月01日至1月21日\n\n可能还有其他活动,请在官方网站等渠道确认最新信息。\n\n\n\n搜索结果:\n\n1. 东京塔 (东京): 当前活动与门票 | Fever\nURL: https://feverup.com/ja/tokyo/venue/tokyo-tower\n摘要: 未找到摘要\n\n\n2. 东京塔(东京都)设施内举办的活动一览|Walkerplus\nURL: https://www.walkerplus.com/spot/ar0313s03867/e_list.html\n摘要: 未找到摘要\n\n\n3. 东京塔 - Tokyo Tower\nURL: https://www.tokyotower.co.jp/event/\n摘要: 未找到摘要\n')] isError=False

3d Printer Server
连接 MCP 到主要的 3D 打印机 API(Orca、Bambu、OctoPrint、Klipper、Duet、Repetier、Prusa、Creality)。控制打印、监控状态,并执行高级 STL 操作,如缩放、旋转、截面编辑和底座扩展。包括切片和可视化。
Abap Adt
一个服务器,它将模型上下文协议(MCP)与SAP ABAP系统连接起来,使像Cline这样的工具能够检索ABAP源代码、表结构和其他开发工件。
Ableton Live Server
MCP 服务器实现,用于控制 Ableton Live OSC
Ableton Mcp
通过支持双向通信系统来控制Ableton Live音乐制作软件,该系统支持音轨创建、MIDI编辑、播放控制、乐器加载和库浏览,适用于音乐创作和声音设计工作流程。

