← 返回目录

Tavily MCP Server

官方

为 AI 代理提供实时搜索、提取、地图和爬取功能的 MCP 服务器。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 88 / 230
Stars: ★ 2.4k 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js 20+ · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 26 天前
工具数: 4

58FMRS · C

Tavily MCP 服务器用于为 AI 助手提供实时网络搜索和提取功能，提供本地或远程部署方式，支持多种客户端。

最强项 · 维护活跃度 13/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

13/20

维护活跃度

13/20

文档质量

12/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: 基于源代码审查：仓库包含TypeScript源代码和测试（src/目录中有测试文件），且存在CI工作流配置（如GitHub Actions）。但服务器清单和具体工具实现未完全核对，且README声称的功能（如爬虫）需要API密钥和外部服务，静态审查无法验证实际行为。因此，合理的启动路径和工具列表似乎存在，但错误处理和边缘情况未充分展示，故可靠性得分不超过12。
安全与权限 13/20: 未发现明显的恶意代码或凭证窃取。API密钥通过环境变量或URL header传递，文档建议避免在URL中硬编码。服务器使用外部网络调用Tavily API，但这是其功能所需。未发现不可逆操作或未确认的危险命令。然而，服务器会发送用户提供的数据到外部服务，且对输出内容的边界控制不明确。没有看到最小权限原则的明确描述，但未发现明显越权。安全评分中等偏高。
维护活跃度 13/20: 仓库由Tavily官方维护，有活跃的提交和发布，提供MIT许可证。但open issues较多（50个），且未提供安全响应渠道的明确信息。星标数和npm下载量表明社区活跃，但治理和版本更新路径未完全展示。
文档质量 12/20: README提供了详细的安装说明、认证方式（API密钥或OAuth）、远程和本地服务器配置、环境变量说明、示例客户端配置，以及教程链接。但缺乏详细的故障排除指南，且未说明API限制、成本和错误处理的局限。文档质量良好但仍有提升空间。
安装易用性 12/20: 提供了通过npx或远程URL的简单安装方法，并包含主流客户端（如Claude Code、Cursor）的配置示例。但需要用户手动获取API密钥并配置，且未提供逐步的安装脚本或自动化测试。因此设置过程清晰但需要手动操作。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要实时网络能力以增强 AI 响应的开发者。
在 Claude Code、Cursor 或任何兼容的 MCP 客户端中工作的用户。
需要快速可靠的数据提取和搜索功能的团队。

不适合谁

不需要实时网络功能的离线应用。
需要大规模爬取的场景，可能超出默认免费层的限制，需要适当的管理。
对数据隐私要求极高且不想将数据发送到外部服务的环境。

所需权限

访问实时网络搜索和提取 API。
通过网络进行数据传输。
需要有效的 Tavily API 密钥以进行身份验证。

风险与副作用

API 密钥可能被滥用或泄露。
可能产生相关费用，具体取决于 Tavily 计划的配额。
可能遇到速率限制或服务中断。
请勿将此服务器视为完全可信任的；使用前请验证其行为。

安装接入

准备工作

运行环境：Node.js 20+ · 远程托管（无需本地环境）

TAVILY_API_KEY 必填密钥 Tavily API 密钥，在 tavily.com 注册免费账号后获取，本地运行必需。

其他可选配置项（2 个）

DEFAULT_PARAMETERS 可选可选，JSON 格式的 tavily-search 默认参数，如 include_images、max_results、search_depth。

TAVILY_HUMAN_ID 可选可选，用于标识终端用户以便按用户分析，会以 X-Human-Id 头转发并在服务端哈希后存储。

在 https://app.tavily.com/home 获取 Tavily API 密钥。
对于本地安装，请确保 Node.js v20+，然后运行 npx -y tavily-mcp@latest。
对于远程安装，请使用 URL https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>。
配置你的 MCP 客户端（如 Claude Code 或 Cursor）以使用上述服务器。

claude_desktop_config.json

{
  "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\"}"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "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\"}"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add tavily-mcp -e TAVILY_API_KEY=your-api-key-here -e 'DEFAULT_PARAMETERS={"include_images": true, "max_results": 15, "search_depth": "advanced"}' -- npx -y tavily-mcp@latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

配置后在客户端工具列表中应出现 tavily-search、tavily-extract、tavily-map 和 tavily-crawl 四个工具；运行一次搜索询问实时信息即可验证连接是否正常。

常见排障

检查 API 密钥是否正确且有效。
确保网络连接稳定。
检查环境变量设置，如 `TAVILY_API_KEY` 和 `DEFAULT_PARAMETERS`。
如果使用 OAuth，请清除 `~/.mcp-auth` 以重新认证。
确保 Node.js 版本满足要求（v20+）。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 tavily-search 搜索最新的 MCP 协议新闻，最多返回 15 条结果
提取 https://example.com 页面的正文内容
为 https://docs.example.com 生成一个网站结构地图
爬取这个博客站点并列出所有文章链接

工具能力 4

tavily-search 只读

实时网络搜索工具，提供最新信息。

tavily-extract 只读

从网页中智能提取结构化数据。

tavily-map 只读

创建网站结构图，以了解网站布局。

tavily-crawl 只读

系统性地遍历网站以收集内容。

使用场景

为 AI 代理提供实时网络搜索，以获取最新信息。

从特定网页提取结构化数据，用于知识图谱或分析。

生成网站地图以了解站点结构。

爬取网站以收集综合数据。

支持客户端

Claude Desktop

Claude Code

Cursor

依据项目文档列出，未经本站实测。

详细介绍

Tavily MCP 服务器为 AI 代理提供实时网络搜索、数据提取、网站地图和爬取功能。它支持通过 npm 本地运行，或通过远程服务器 URL 连接，并支持 API 密钥和 OAuth 认证。