Tavily MCP Server已精选

什么是 Tavily MCP Server？

Tavily MCP Server 是 Tavily 官方的 MCP 集成。它通过 Tavily API 为 AI 助手提供实时网页搜索、网页内容提取、站点地图、爬取和多来源研究。你可以直接使用托管的远程服务器，也可以用 npx 在本地运行。

该项目由 Tavily 维护（tavily-ai/tavily-mcp，MIT 许可证），支持 Claude Code、Claude Desktop、Cursor 以及其他任何 MCP 客户端。托管端点支持三种认证方式：在 URL 中带 API key、使用 Bearer 请求头，或通过 OAuth 登录。

如何使用 Tavily MCP Server？

你需要先在 app.tavily.com 获取 Tavily API key。Tavily 提供免费账户，其文档说明免费 key 每月含 1,000 credits，无需信用卡。key 以 tvly- 开头。如果使用本地服务器，还需要 Node.js 20 或更高版本。

远程（托管）URL，无需安装：

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

如果客户端支持自定义请求头，可以不把 key 放在 URL 里，改为发送 Authorization: Bearer <your-api-key>。也可以不带 key 连接 https://mcp.tavily.com/mcp，再通过 OAuth 登录。

本地（stdio）：

npx -y tavily-mcp@latest

运行前需在环境变量中设置 TAVILY_API_KEY。

Claude Code

在 URL 中带上 API key，添加托管的 Tavily MCP 服务器：

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

也可以不带 key 添加，改用 OAuth：

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

然后运行 claude，输入 /mcp，选中 Tavily 服务器完成登录。在任一命令中加上 --scope user，即可在所有项目中使用。

Claude Desktop

在 claude_desktop_config.json 中添加本地服务器（macOS 位于 ~/Library/Application Support/Claude/，Windows 位于 %APPDATA%\Claude\）：

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

Tavily 文档还介绍了另一种方式：在 Claude Desktop 设置中把远程 URL 添加为 integration。

Cursor

点击 README 中的“Add to Cursor”按钮，或在 mcp.json 中加入以下配置并替换 key：

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

如需改用 OAuth，把命令换成 npx mcp-remote https://mcp.tavily.com/mcp。

其他客户端

只支持本地 stdio 服务器的客户端，可以通过 mcp-remote 桥接连接托管服务器：

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

默认参数：本地运行时设置环境变量 DEFAULT_PARAMETERS，使用远程服务器时发送 DEFAULT_PARAMETERS 请求头，内容为 JSON，例如 {"include_images": true, "max_results": 15, "search_depth": "advanced"}。

Tavily MCP Server 的主要功能

• 由 Tavily 官方开发和维护，MIT 许可证，以 tavily-mcp 发布在 npm 上。
• 提供托管远程端点 mcp.tavily.com，无需本地安装。
• 远程服务器支持三种认证方式：查询参数中的 API key、Bearer 请求头或 OAuth。
• 搜索可设置深度（basic、advanced、fast、ultra-fast）、主题（general 或 news）、时间范围、起止日期，以及要包含或排除的域名。
• 提取功能以 markdown 或纯文本返回页面内容，便于 LLM 直接读取。
• 支持站点地图和网站爬取，深度和广度可配置。
• 研究工具可汇总多个来源的信息，生成一份详细回答。
• 用 DEFAULT_PARAMETERS 一次性设置搜索默认值；可选的 TAVILY_HUMAN_ID 会转发终端用户 ID 用于分析，Tavily 会在存储前对该 ID 做哈希处理。

Tavily MCP Server 工具

工具分为三组：

• 搜索：tavily_search 执行实时网页搜索，返回摘要和来源 URL，适合查询新闻、近期事件以及模型训练截止日期之后的事实。
• 读取网站：tavily_extract 返回一个或多个 URL 的内容；tavily_map 从基础 URL 出发，列出站点中发现的 URL；tavily_crawl 从起始 URL 开始浏览站点，并提取所访问页面的内容。
• 研究：tavily_research 针对较宽泛的问题从多个来源收集信息，返回详细回答。其工具说明中的速率限制为每分钟 20 次请求。

Tavily MCP Server 的使用场景

• 时事与事实核查：“搜索过去 7 天关于 AI 初创公司的新闻报道。”
• 在指定网站内搜索：“在 nature.com 和 sciencedirect.com 上搜索气候变化研究。”
• 阅读文章：“提取 https://example.com/article 的正文并总结。”
• 在编程助手中查文档：在 Claude Code 或 Cursor 中接入 Tavily，让 agent 写代码时能查阅最新的库文档。
• 梳理网站结构：“对 docs.example.com 生成站点地图，列出 /guides 下的所有页面。”
• 研究报告：“研究固态电池的最新进展，并给出带来源的总结。”

Tavily MCP Server 与替代方案对比

• Exa MCP Server 是另一款面向 AI agent 的搜索 API，可根据你的查询结果质量和价格来选择。
• Firecrawl MCP Server 侧重抓取和爬取；Tavily 以搜索为主，同时也提供提取、站点地图和爬取功能。
• Puppeteer MCP Server 和 Playwright MCP Server 驱动真实浏览器。当页面需要点击、登录或填写表单，而不只是简单抓取时，使用它们。

社区中还有多个 “Tavily MCP” 分支；本页面对应的是 tavily-ai 官方仓库。

Tavily MCP Server 常见问题排查

• 找不到服务器或无法启动：运行 node --version 和 npm --version，确认 Node.js 版本不低于 20，并检查配置文件的 JSON 语法是否有误。
• 桌面应用中找不到 npx：运行 which npx，把 npx 的完整路径填入 command 字段。
• API key 无效或超出用量：确认 key 以 tvly- 开头，且在 Tavily 控制台中处于有效状态。可以在 Tavily Playground 中测试。
• OAuth 卡住或登录了错误的账户：运行 rm -rf ~/.mcp-auth 清除已保存的凭据，然后重新登录。如需指定 OAuth 使用哪个 key，在 Tavily 账户中把它命名为 mcp_auth_default。
• 工具名称不一致：旧文档写作 tavily-search 和 tavily-extract；当前版本的 tavily_search、tavily_extract 等工具均使用下划线。