article
README
🚀 Tavily-MCP 项目文档
Tavily-MCP 是一个实用的项目,可帮助用户在 Claude 桌面应用中集成相关功能,实现网络搜索、内容提取等操作,提升使用效率。
🚀 快速开始
Tavily-MCP 可通过 npm 或手动克隆仓库的方式进行安装,安装完成后进行相应配置即可在 Claude 桌面应用中使用。
📦 安装指南
1. 使用 npm 安装
步骤 1: 安装依赖
在终端或命令提示符中运行以下命令以安装 Tavily-MCP:
npm install tavily-mcp
步骤 2: 启动服务器
成功安装后,启动 Tavily-MCP 服务器:
tavily-mcp start
2. 手动安装
步骤 1: 克隆仓库
在终端或命令提示符中运行以下命令以克隆 Tavily-MCP 仓库:
git clone https://github.com/tavily-ai/tavily-mcp.git
cd tavily-mcp
步骤 2: 安装依赖
进入仓库目录后,安装所有依赖项:
npm install
步骤 3: 构建项目
构建项目以生成可执行文件:
npm run build
🛠️ 配置指南
在 Claude 桌面应用中配置
-
打开配置文件:
- macOS:
code ~/Library/Application\ Support/Claude/claude_desktop_config.json - Windows:
code %APPDATA%\Claude\claude_desktop_config.json
- macOS:
-
添加 Tavily-MCP 服务器配置:
{ "mcpServers": { "tavily-mcp": { "command": "npx", "args": ["-y", "tavily-mcp@1.0.0"], "env": { "TAVILY_API_KEY": "your-api-key-here" } } } }- 将
your-api-key-here替换为您的实际 Tavily API 密钥。
- 将
💻 使用指南
在 Claude 桌面应用中的使用
- 安装完成后,完全关闭并重新打开 Claude 桌面应用以使配置生效。
- 应用底部左侧会出现一个锤子图标,表示有可用的 MCP 工具。点击该图标可查看更多详细信息。
💡 功能示例
Tavily Search 示例
通用网络搜索
你能查找量子计算领域的最新发展吗?
新闻搜索
查找过去一周关于 AI 初创公司的新闻文章。
特定领域搜索
在 nature.com 和 sciencedirect.com 搜索气候变化的研究
Tavily Extract 示例
提取文章内容
从这篇文章 https://example.com/article 中提取主要内容
组合使用 Search 和 Extract
您可以结合 Tavily-Search 和 Tavily-Extract 工具来执行更复杂的任务。
搜索过去一周关于 AI 初创公司的新闻文章,并提取每篇文章的主要内容以生成详细报告。
🛠️ 故障排除
常见问题
服务器未找到
- 验证 npm 安装状态,运行
npm --version。 - 检查 Claude 桌面应用配置文件语法,运行
code ~/Library/Application\ Support/Claude/claude_desktop_config.json。 - 确保 Node.js 正确安装,运行
node --version。
NPX 相关问题
- 如果遇到与
npx相关的错误,请使用 npx 的完整路径替换配置中的"command": "npx"。然后在配置中替换为:which npx"command": "/full/path/to/npx"
API 密钥问题
- 确认您的 Tavily API 密钥有效。
- 检查密钥是否正确设置在配置文件中。
- 确保密钥没有空格或引号。
🙏 致谢
- Model Context Protocol 提供 MCP 规范
- Anthropic 提供 Claude 桌面应用
扫码联系在线客服