Tavily MCP Server

模型上下文协议（MCP）是一项开放标准，可让 AI 系统与各种数据源和工具无缝交互，从而实现安全的双向连接。

由 Anthropic 开发的模型上下文协议（MCP）可让 Claude 等 AI 助手无缝集成 Tavily 的高级搜索和数据提取功能。此集成可让 AI 模型实时访问网络信息，并提供高级筛选选项和特定领域的搜索功能。

Tavily MCP 服务提供：

• search、extract、map、crawl 工具
• 通过 tavily-search 工具提供实时网页搜索功能
• 通过 tavily-extract 工具智能提取网页数据
• 强大的网页映射工具，可创建网站的结构化地图
• 可系统探索网站的网页爬虫

📚 实用资源

• 教程，介绍如何将 Tavily MCP 与 Neo4j MCP 服务结合使用
• 教程，介绍如何将 Tavily MCP 与 VS Code 中的 Cline 集成

前提条件 🔧

开始之前，请确保你已准备好：

• Tavily API 密钥
  • 如果你还没有 Tavily API 密钥，可以在此处注册免费账户
• Claude Desktop 或 Cursor
• Node.js（v20 或更高版本）
  • 运行以下命令，确认 Node.js 已安装：
    • node --version
• 已安装 Git（仅在使用 Git 安装方式时需要）
  • macOS：brew install git
  • Linux：
    • Debian/Ubuntu：sudo apt install git
    • RedHat/CentOS：sudo yum install git
  • Windows：下载 Git for Windows

安装 Tavily MCP 服务 ⚡

使用 NPX 运行

npx -y tavily-mcp@latest 

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Tavily MCP 服务：

npx -y @smithery/cli install @tavily-ai/tavily-mcp --client claude

虽然你可以单独启动服务，但单独使用它并没有太大帮助。你应该将其集成到 MCP 客户端中。以下是配置 Claude Desktop 应用以配合 tavily-mcp 服务工作的示例。

配置 MCP 客户端 ⚙️

本文档将介绍如何配置 VS Code、Cursor 和 Claude Desktop，使其与 tavily-mcp 服务协同工作。

配置 VS Code 💻

如需一键安装，请点击下方任一安装按钮：

手动安装

请先检查本节顶部是否有符合需求的安装按钮。如果你更喜欢手动安装，请按以下步骤操作：

将以下 JSON 代码块添加到 VS Code 的用户设置（JSON）文件中。你可以按 Ctrl + Shift + P（macOS 上按 Cmd + Shift + P），然后输入 Preferences: Open User Settings (JSON) 来打开该文件。

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "tavily_api_key",
        "description": "Tavily API Key",
        "password": true
      }
    ],
    "servers": {
      "tavily": {
        "command": "npx",
        "args": ["-y", "tavily-mcp@latest"],
        "env": {
          "TAVILY_API_KEY": "${input:tavily_api_key}"
        }
      }
    }
  }
}

你也可以选择将其添加到工作区中名为 .vscode/mcp.json 的文件：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "tavily_api_key",
      "description": "Tavily API Key",
      "password": true
    }
  ],
  "servers": {
    "tavily": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "${input:tavily_api_key}"
      }
    }
  }
}

配置 Cline 🤖

在 Cline 中设置 Tavily MCP 服务最简单的方式是在扩展市场中一键安装：

1. 在 VS Code 中打开 Cline
2. 点击侧边栏中的 Cline 图标
3. 转到“MCP Servers”选项卡（4 个方块）
4. 搜索“Tavily”并点击“install”
5. 按提示输入 Tavily API 密钥

或者，你也可以在 Cline 中手动设置 Tavily MCP 服务：

1. 打开 Cline MCP 设置文件：

   macOS：

   # Using Visual Studio Code
   code ~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   
   # Or using TextEdit
   open -e ~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   

   Windows：

   code %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
   

2. 将 Tavily 服务配置添加到文件中：

   将 your-api-key-here 替换为你的实际 Tavily API 密钥。

   {
     "mcpServers": {
       "tavily-mcp": {
         "command": "npx",
         "args": ["-y", "tavily-mcp@latest"],
         "env": {
           "TAVILY_API_KEY": "your-api-key-here"
         },
         "disabled": false,
         "autoApprove": []
       }
     }
   }
   

3. 保存文件；如果 Cline 已在运行，请重启它。

4. 使用 Cline 时，你现在可以使用 Tavily MCP 工具。你可以在对话中直接让 Cline 使用 tavily-search 和 tavily-extract 工具。

配置 Cursor 🖥️

注意：需要 Cursor 版本 0.45.6 或更高版本

要在 Cursor 中设置 Tavily MCP 服务：

1. 打开 Cursor 设置
2. 转到 Features > MCP Servers
3. 点击“+ Add New MCP Server”按钮
4. 填写以下信息：
   • 名称：输入服务的昵称（例如，“tavily-mcp”）
   • 类型：选择“command”作为类型
   • 命令：输入运行服务的命令：

     env TAVILY_API_KEY=your-api-key npx -y tavily-mcp@latest
     

     重要：将 your-api-key 替换为你的 Tavily API 密钥。你可以在 app.tavily.com/home 获取密钥

添加服务后，它应该会显示在 MCP 服务列表中。你可能需要手动点击 MCP 服务右上角的刷新按钮，才能加载工具列表。

当与你的查询相关时，Composer Agent 会自动使用 Tavily MCP 工具。最好明确说明希望使用这些工具并描述要执行的操作（例如，“使用 tavily-search 搜索网络，查找 AI 领域的最新新闻”）。在 Mac 上，按 command + L 打开聊天，在屏幕顶部选择 composer 选项，然后在提交按钮旁选择 agent，准备好后提交查询。

配置 Claude 桌面应用 🖥️

macOS：

# Create the config file if it doesn't exist
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Opens the config file in TextEdit 
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Alternative method using Visual Studio Code (requires VS Code to be installed)
code "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

适用于 Windows：

code %APPDATA%\Claude\claude_desktop_config.json

添加 Tavily 服务配置：

将 your-api-key-here 替换为你实际的 Tavily API 密钥。

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "your-api-key-here"
      }
    }
  }
}

2. Git 安装

1. 克隆代码库：

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

2. 安装依赖：

npm install

3. 构建项目：

npm run build

配置 Claude 桌面应用 ⚙️

按照上文 配置 Claude 桌面应用 部分中的配置步骤，使用以下 JSON 配置。

将 your-api-key-here 替换为你实际的 Tavily API 密钥，并将 /path/to/tavily-mcp 替换为你在系统上克隆代码库的实际路径。

{
  "mcpServers": {
    "tavily": {
      "command": "npx",
      "args": ["/path/to/tavily-mcp/build/index.js"],
      "env": {
        "TAVILY_API_KEY": "your-api-key-here"
      }
    }
  }
}

在 Claude 桌面应用中使用 🎯

安装完成并配置好 Claude 桌面应用后，你必须完全关闭并重新打开 Claude 桌面应用，才能看到 tavily-mcp 服务。你应该会在应用左下角看到一个锤子图标，表示有可用的 MCP 工具。点击锤子图标，即可查看更多有关 tavily-search 和 tavily-extract 工具的详细信息。

现在，Claude 将可以完全访问 tavily-mcp 服务，包括 tavily-search 和 tavily-extract 工具。如果你将以下示例输入 Claude 桌面应用，就能看到 tavily-mcp 服务工具的实际效果。

Tavily 搜索示例

1. 常规网页搜索：

Can you search for recent developments in quantum computing?

2. 新闻搜索：

Search for news articles about AI startups from the last 7 days.

3. 特定域名搜索：

Search for climate change research on nature.com and sciencedirect.com

Tavily 提取示例

1. 提取文章内容：

Extract the main content from this article: https://example.com/article

✨ 结合搜索和提取 ✨

你也可以结合使用 tavily-search 和 tavily-extract 工具来执行更复杂的任务。

Search for news articles about AI startups from the last 7 days and extract the main content from each article to generate a detailed report.

故障排除 🛠️

常见问题

1. 找不到服务

   • 运行 npm --verison 验证 npm 是否已安装
   • 运行 code ~/Library/Application\ Support/Claude/claude_desktop_config.json 检查 Claude Desktop 配置语法
   • 运行 node --version 确认 Node.js 已正确安装

2. 与 NPX 相关的问题

• 如果遇到与 npx 相关的错误，可能需要改用 npx 可执行文件的完整路径。
• 在终端中运行 which npx 查找该路径，然后在配置中将 "command": "npx" 替换为 "command": "/full/path/to/npx"。

3. API 密钥问题
   • 确认你的 Tavily API 密钥有效
   • 检查配置中是否正确设置了 API 密钥
   • 确认 API 密钥前后没有空格或引号

致谢 ✨

• 感谢 Model Context Protocol 提供 MCP 规范
• 感谢 Anthropic 提供 Claude Desktop