🚀 Tavily-MCP 项目文档

Tavily-MCP 项目为 Claude 桌面应用提供了强大的搜索与内容提取功能，通过集成 Tavily 服务，用户可以在应用内进行网络搜索和文章内容提取等操作。

🚀 快速开始

若要使用 Tavily-MCP 服务，你需要先完成安装和配置。安装方式有使用 npm 安装和手动安装两种，配置则需在 Claude 桌面应用中进行。安装和配置完成后，即可在应用中使用相关工具。

📦 安装指南

第一部分：使用 npm 安装

1. 安装依赖：

   npm install -g tavily-mcp
   

2. 启动服务：

   tavily-mcp start
   

3. 验证安装： 如果看到类似以下输出，则表示安装成功：

   tavily-mcp 正在监听...
   

第二部分：手动安装

1. 克隆仓库：

   git clone https://github.com/tavily-ai/tavily-mcp.git
   cd tavily-mcp
   

2. 安装依赖：

   npm install
   

3. 构建项目：

   npm run build
   

📚 详细文档

配置指南

在 Claude 桌面应用中配置 Tavily-MCP 服务

1. 编辑配置文件： 根据你的操作系统，找到对应的配置文件路径：
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
2. 添加 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"
         }
       }
     }
   }
   

3. 保存并重启应用： 完成配置后，关闭并重新打开 Claude 桌面应用以使更改生效。

使用指南

在 Claude 桌面应用中使用 Tavily-MCP 服务

• 启动应用后，底部左侧应显示一个小锤子图标，表示 MCP 工具已可用。
• 点击该图标即可查看 tavily-search 和 tavily-extract 工具的具体信息。

示例用法

基础用法

• Tavily 搜索示例
  • 通用网络搜索：

    你能搜索量子计算领域的最新发展吗？
    

  • 新闻搜索：

    搜索过去一周关于人工智能初创公司的新闻文章。
    

  • 特定领域搜索：

    在 nature.com 和 sciencedirect.com 上搜索关于气候变化的研究。
    

• Tavily 提取示例
  • 提取文章内容：

    从这个网页中提取主要内容：https://example.com/article
    

高级用法

• 组合使用搜索与提取 将搜索和提取工具结合，执行更复杂的任务：

  搜索过去一周关于人工智能初创公司的新闻文章，并提取每篇文章的主要内容以生成详细报告。
  

故障排除

常见问题

1. 服务未找到
   • 确认 npm 安装成功：运行 npm --version
   • 检查 Claude 配置文件语法：运行 code ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • 确保 Node.js 正确安装：运行 node --version
2. NPX 相关问题
   • 查找 npx 的完整路径：运行 which npx
   • 将配置文件中的 "command": "npx" 替换为完整的路径。
3. API 密钥问题
   • 确认 API 密钥有效
   • 检查密钥在配置中正确无误
   • 确保没有多余的空格或引号

其他资源

• 模型上下文协议 提供 MCP 规范
• Anthropic 提供 Claude 桌面应用