Tavily MCP 服务器

Tavily MCP 服务器提供：

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

📚 有用的资源

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

远程 MCP 服务器

无需在本地运行，直接连接到 Tavily 的远程 MCP 服务器即可。这样可以带来无缝的使用体验，而无需进行本地安装或配置。

只需使用带有 Tavily API 密钥的远程 MCP 服务器 URL：

https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key> 

请从 tavily.com 获取您的 Tavily API 密钥。

或者，如果 MCP 客户端支持，您也可以通过 Authorization 头传递 API 密钥：

Authorization: Bearer <your-api-key>

注意： 使用远程 MCP 时，可以通过包含一个 JSON 对象的 DEFAULT_PARAMETERS 头来为所有请求指定默认参数。例如：

{"include_images":true, "search_depth": "basic", "max_results": 10}

连接到 Claude Code

Claude Code 是 Anthropic 官方提供的用于 Claude 的命令行工具。您可以使用 claude mcp add 命令添加 Tavily MCP 服务器。有两种认证方式：

选项 1：URL 中的 API 密钥

直接在 URL 中传递您的 API 密钥。将 <your-api-key> 替换为您实际的 Tavily API 密钥：

claude mcp add --transport http tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>

选项 2：OAuth 认证流程

不带 API 密钥的 URL 添加服务器：

claude mcp add --transport http tavily https://mcp.tavily.com/mcp

添加后，您需要完成认证流程：

1. 运行 claude 启动 Claude Code
2. 输入 /mcp 打开 MCP 服务器管理界面
3. 选择 Tavily 服务器并完成认证过程

提示： 在任一命令中添加 --scope user，使 Tavily MCP 服务器在您所有的项目中全局可用：

claude mcp add --transport http --scope user tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>

配置完成后，您将可以访问 Tavily 的搜索、提取、映射和爬取工具。

连接到 Cursor

点击 ⬆️ 添加到 Cursor ⬆️ 按钮，这将为您完成大部分工作，但您仍然需要编辑配置以添加您的 API 密钥。您可以在 这里 获取 Tavily API 密钥。

点击按钮后，您应该会被重定向到 Cursor……

第一步

点击安装按钮

第二步

您应该会看到 MCP 已经安装完毕，如果蓝色滑块尚未打开，请手动将其打开。此外，您还需要编辑配置文件，加入您自己的 Tavily API 密钥。

第三步

随后您会被重定向到您的 mcp.json 文件，在那里您需要添加“your-api-key”。

{
  "mcpServers": {
    "tavily-remote-mcp": {
      "command": "npx -y mcp-remote https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>",
      "env": {}
    }
  }
}

远程 MCP 服务器 OAuth 流程

Tavily 远程 MCP 服务器支持安全的 OAuth 认证，允许您与兼容的客户端无缝连接并授权。

如何设置 OAuth 认证

A. 使用 MCP Inspector：

• 打开 MCP Inspector 并点击“打开认证设置”。
• 选择 OAuth 流程并完成以下步骤：
  1. 元数据发现
  2. 客户端注册
  3. 准备授权
  4. 请求授权并获取授权码
  5. 请求令牌
  6. 认证完成

完成之后，您将获得一个访问令牌，可用于安全地向 Tavily 远程 MCP 服务器发送经过身份验证的请求。

B. 使用其他 MCP 客户端（例如 Cursor）：

您可以在不将 Tavily API 密钥包含在 URL 中的情况下，配置您的 MCP 客户端以使用 OAuth。例如，在您的 mcp.json 中：

{
  "mcpServers": {
    "tavily-remote-mcp": {
      "command": "npx mcp-remote https://mcp.tavily.com/mcp",
      "env": {}
    }
  }
}

如果您需要清除已存储的 OAuth 凭据并重新认证，可以运行：

rm -rf ~/.mcp-auth

注意：

• OAuth 认证是可选的。您仍然可以随时使用 API 密钥认证，方法是在 URL 查询参数中包含您的 Tavily API 密钥（?tavilyApiKey=...），或按照上述说明将其设置在 Authorization 头中。

选择用于 OAuth 的 API 密钥

成功完成 OAuth 认证后，您可以控制使用的 API 密钥，只需将其命名为 mcp_auth_default：

• 如果您在 个人账户 中设置了名为 mcp_auth_default 的密钥，则该密钥将用于认证流程。
• 如果您属于一个拥有名为 mcp_auth_default 的密钥的 团队，则该团队的密钥将用于认证流程。
• 如果您同时拥有个人密钥和团队密钥，并且都命名为 mcp_auth_default，则 个人密钥将优先。
• 如果未设置 mcp_auth_default 密钥，则将使用您个人账户中的 默认密钥。若未设置默认密钥，则将使用第一个可用的密钥。

本地 MCP

前置条件 🔧

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

• 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

使用 NPX 运行

npx -y tavily-mcp@latest 

默认参数配置 ⚙️

你可以使用 DEFAULT_PARAMETERS 环境变量为 tavily-search 工具设置默认参数值。这样，你无需在每次请求中都指定这些参数，即可配置默认的搜索行为。

配置示例

export DEFAULT_PARAMETERS='{"include_images": true}'

客户端使用示例

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "your-api-key-here",
        "DEFAULT_PARAMETERS": "{\"include_images\": true, \"max_results\": 15, \"search_depth\": \"advanced\"}"
      }
    }
  }
}

致谢 ✨

• Model Context Protocol 提供的 MCP 规范
• Anthropic 及其 Claude Desktop

Tavily MCP 快速上手指南

Tavily MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，为 AI 助手提供实时网络搜索、智能数据提取、网站地图构建及爬虫功能。

环境准备

在开始之前，请确保满足以下前置条件：

• Tavily API Key：访问 tavily.com 注册账号并获取 API Key。
• Node.js：版本需为 v20 或更高。
  • 验证命令：node --version
• 客户端工具（任选其一）：
  • Claude Desktop
  • Cursor 编辑器
• Git（仅本地部署需要）：
  • macOS: brew install git
  • Linux (Debian/Ubuntu): sudo apt install git
  • Windows: 下载 Git for Windows

提示：国内开发者若遇到 npm 安装缓慢问题，可配置淘宝镜像源： npm config set registry https://registry.npmmirror.com

---

安装与配置

根据您的需求，可选择远程模式（推荐，无需本地运行服务）或本地模式。

方案一：连接远程 MCP 服务器（推荐）

此方式无需在本地启动 Node 服务，直接通过 URL 连接 Tavily 云端服务。

1. 在 Claude Code 中配置

打开终端，执行以下命令（二选一）：

选项 A：直接在 URL 中传入 API Key

claude mcp add --transport http tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>

将 <your-api-key> 替换为您的真实 Key。添加 --scope user 参数可使配置对所有项目生效。

选项 B：使用 OAuth 认证流程

claude mcp add --transport http tavily https://mcp.tavily.com/mcp

执行后，运行 claude 启动程序，输入 /mcp 进入管理界面，选择 Tavily 服务器完成授权登录。

2. 在 Cursor 中配置

1. 点击官方安装按钮（或在 Cursor 设置中手动配置）。
2. 打开 Cursor 的 mcp.json 配置文件。
3. 填入以下配置，并将 <your-api-key> 替换为您的 Key：

{
  "mcpServers": {
    "tavily-remote-mcp": {
      "command": "npx -y mcp-remote https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>",
      "env": {}
    }
  }
}

4. 保存文件，确保 MCP 开关已开启（蓝色状态）。

---

方案二：本地运行 MCP 服务器

如果您需要在本地完全控制服务运行：

1. 在终端执行以下命令启动服务：

   npx -y tavily-mcp@latest 
   

2. 在客户端配置中引用该服务，并设置环境变量：

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "your-api-key-here",
        "DEFAULT_PARAMETERS": "{\"include_images\": true, \"max_results\": 15, \"search_depth\": \"advanced\"}"
      }
    }
  }
}

---

基本使用

配置完成后，重启您的 AI 客户端（Claude 或 Cursor），即可在对话中直接使用以下能力：

• 实时搜索：询问最新新闻、技术文档或实时数据（调用 tavily-search）。
• 内容提取：提供 URL，让 AI 读取并总结网页核心内容（调用 tavily-extract）。
• 网站映射：分析网站结构，生成站点地图（调用 tavily-map）。
• 深度爬取：系统性探索特定网站的多个页面（调用 tavily-crawl）。

使用示例：

“请搜索关于 Rust 语言最新版本的性能优化特性，并提取官方博客中的关键代码示例。” “帮我分析 https://example.com 的网站结构，列出主要栏目。”

高级配置：默认参数

您可以通过设置 DEFAULT_PARAMETERS 环境变量来定制默认行为（如始终包含图片、限制结果数量等）。

Linux/macOS 临时设置：

export DEFAULT_PARAMETERS='{"include_images": true}'

在 mcp.json 中永久设置： 参考上方“本地运行”配置块中的 env 部分，修改 DEFAULT_PARAMETERS 的 JSON 值即可。