Tavily-MCP 项目文档

安装指南

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 桌面应用中配置

1. 打开配置文件：

   • macOS:

     code ~/Library/Application\ Support/Claude/claude_desktop_config.json
     

   • Windows:

     code %APPDATA%\Claude\claude_desktop_config.json
     

2. 添加 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 桌面应用中的使用

1. 安装完成后，完全关闭并重新打开 Claude 桌面应用以使配置生效。
2. 应用底部左侧会出现一个锤子图标，表示有可用的 MCP 工具。点击该图标可查看更多详细信息。

功能示例

Tavily Search 示例

1. 通用网络搜索：

   你能查找量子计算领域的最新发展吗？
   

2. 新闻搜索：

   查找过去一周关于 AI 初创公司的新闻文章。
   

3. 特定领域搜索：

   在 nature.com 和 sciencedirect.com 搜索气候变化的研究
   

Tavily Extract 示例

1. 提取文章内容：

   从这篇文章 https://example.com/article 中提取主要内容
   

组合使用 Search 和 Extract

您可以结合 Tavily-Search 和 Tavily-Extract 工具来执行更复杂的任务。

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

故障排除

常见问题

1. 服务器未找到

   • 验证 npm 安装状态，运行 npm --version。
   • 检查 Claude 桌面应用配置文件语法，运行 code ~/Library/Application\ Support/Claude/claude_desktop_config.json。
   • 确保 Node.js 正确安装，运行 node --version。

2. NPX 相关问题

   • 如果遇到与 npx 相关的错误，请使用 npx 的完整路径替换配置中的 "command": "npx"。

     which npx
     

     然后在配置中替换为：

     "command": "/full/path/to/npx"
     

3. API 密钥问题

   • 确认您的 Tavily API 密钥有效。
   • 检查密钥是否正确设置在配置文件中。
   • 确保密钥没有空格或引号。

致谢

• Model Context Protocol 提供 MCP 规范
• Anthropic 提供 Claude 桌面应用