article
README
🚀 Tavily-MCP 项目文档
Tavily-MCP 项目为 Claude 桌面应用提供了强大的搜索与内容提取功能,通过集成 Tavily 服务,用户可以在应用内进行网络搜索和文章内容提取等操作。
🚀 快速开始
若要使用 Tavily-MCP 服务,你需要先完成安装和配置。安装方式有使用 npm 安装和手动安装两种,配置则需在 Claude 桌面应用中进行。安装和配置完成后,即可在应用中使用相关工具。
📦 安装指南
第一部分:使用 npm 安装
- 安装依赖:
npm install -g tavily-mcp - 启动服务:
tavily-mcp start - 验证安装:
如果看到类似以下输出,则表示安装成功:
tavily-mcp 正在监听...
第二部分:手动安装
- 克隆仓库:
git clone https://github.com/tavily-ai/tavily-mcp.git cd tavily-mcp - 安装依赖:
npm install - 构建项目:
npm run build
📚 详细文档
配置指南
在 Claude 桌面应用中配置 Tavily-MCP 服务
- 编辑配置文件:
根据你的操作系统,找到对应的配置文件路径:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
- 添加 Tavily-MCP 服务配置:
将以下内容添加到配置文件中,记得替换
/path/to/tavily-mcp为你的实际路径,并填写有效的 API 密钥。{ "mcpServers": { "tavily": { "command": "npx", "args": ["-y", "/path/to/tavily-mcp/build/index.js"], "env": { "TAVILY_API_KEY": "your-api-key-here" } } } } - 保存并重启应用: 完成配置后,关闭并重新打开 Claude 桌面应用以使更改生效。
使用指南
在 Claude 桌面应用中使用 Tavily-MCP 服务
- 启动应用后,底部左侧应显示一个小锤子图标,表示 MCP 工具已可用。
- 点击该图标即可查看
tavily-search和tavily-extract工具的具体信息。
示例用法
基础用法
- Tavily 搜索示例
- 通用网络搜索:
你能搜索量子计算领域的最新发展吗? - 新闻搜索:
搜索过去一周关于人工智能初创公司的新闻文章。 - 特定领域搜索:
在 nature.com 和 sciencedirect.com 上搜索关于气候变化的研究。
- 通用网络搜索:
- Tavily 提取示例
- 提取文章内容:
从这个网页中提取主要内容:https://example.com/article
- 提取文章内容:
高级用法
- 组合使用搜索与提取
将搜索和提取工具结合,执行更复杂的任务:
搜索过去一周关于人工智能初创公司的新闻文章,并提取每篇文章的主要内容以生成详细报告。
故障排除
常见问题
- 服务未找到
- 确认 npm 安装成功:运行
npm --version - 检查 Claude 配置文件语法:运行
code ~/Library/Application\ Support/Claude/claude_desktop_config.json - 确保 Node.js 正确安装:运行
node --version
- 确认 npm 安装成功:运行
- NPX 相关问题
- 查找 npx 的完整路径:运行
which npx - 将配置文件中的
"command": "npx"替换为完整的路径。
- 查找 npx 的完整路径:运行
- API 密钥问题
- 确认 API 密钥有效
- 检查密钥在配置中正确无误
- 确保没有多余的空格或引号
扫码联系在线客服