/ 目录 / 演练场 / Tavily MCP
● 官方 tavily-ai 🔑 需要你的密钥

Tavily MCP

作者 tavily-ai · tavily-ai/tavily-mcp

Tavily MCP 为您的代理提供网络搜索、页面提取、站点地图和爬行功能 - 已经针对 LLM 进行了格式化,因此您不会在抓取的标记上浪费令牌。

Tavily 是一个专为 AI 代理设计的搜索 API:答案以带有源的干净文本形式返回,而不是 50 KB 的 HTML。 MCP 服务器提供四种工具(搜索、提取、地图、爬网),您可以将它们组合成真正的研究工作流程。 需要 tavilly.com 提供的免费 API 密钥。 在 Claude Desktop、Cursor、Windsurf、Claude Code 中开箱即用 — 通过 npx 安装。

为什么要用

核心特性

实时演示

实际使用效果

tavily-mcp.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ],
      "env": {
        "TAVILY_API_KEY": "tvly-..."
      }
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ],
      "env": {
        "TAVILY_API_KEY": "tvly-..."
      }
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ],
      "env": {
        "TAVILY_API_KEY": "tvly-..."
      }
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ],
      "env": {
        "TAVILY_API_KEY": "tvly-..."
      }
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "tavily-mcp",
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "tavily-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "tavily-mcp@latest"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add tavily-mcp -- npx -y tavily-mcp@latest

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: Tavily MCP

回答有关模型截止后发生的事情的问题

👤 任何使用 Claude 提出需要新鲜信息的问题的人 ⏱ ~5 min beginner

何时使用: 您询问 2026 年版本、最近的 CVE、新的定价页面或当今的市场 - 模型不知道,必须去查看。

前置条件
  • 泰维利 API 密钥 — 在 tavilly.com 上注册(免费套餐 = 1,000 次通话/月)
  • 泰利MCP已安装 — 将上面的配置块粘贴到客户端的 MCP 设置中
步骤
  1. 直接询问
    Anthropic 本月在 Claude Sonnet 4.7 中发布了什么? 使用 Tavilly 查找公告并总结来源。✓ 已复制
    → 代理调用 tavilly_search,返回带有链接源的摘要
  2. 深入研究一个来源
    第二个来源看起来最权威——使用 tavilly_extract 提取其全文并引用有关上下文窗口的确切行。✓ 已复制
    → 直接引用 URL + 段落编号

结果: 当前,一轮引用的答案 - 无需手动谷歌搜索。

注意事项
  • 搜索首先返回 SEO 垃圾 — 添加站点提示:“...来自 anthropic.com 或 anthropic 的官方博客”
  • 摘要偏离来源 — 需要直接引用——“释义但准确保留数字、日期、名称”
搭配使用: filesystem · memory

在一次会话中扫描竞争产品

👤 产品经理、创始人、营销人员 ⏱ ~30 min intermediate

何时使用: 在一天结束之前,您需要针对给定功能类别的每个竞争对手提供一页的简介。

步骤
  1. 发现竞争对手
    使用 Tavilly,在“面向中小企业的人工智能原生 CRM”中找到与我们竞争的前 8 个产品。 对于每个,返回名称、URL、一行语句、创建年份。✓ 已复制
    → 带有源链接的结构化 8 行表
  2. 绘制每个站点的地图
    对于每个竞争对手,tavilly_map 他们的网站以找到他们的定价和功能页面。 返回 URL。✓ 已复制
    → 每个竞争对手 2 个 URL
  3. 提取定价
    tavilly_extract 每个定价页面并构建比较网格:计划名称、每月价格、前 3 个差异点。✓ 已复制
    → 清洁网格; 单元格引用定价页面 URL

结果: 包含来源的可共享简报 — 30 分钟内即可制作 PMM 幻灯片。

注意事项
  • JS 渲染和提取的定价错过了它 — 使用 render=on 回退到 tavily_crawl,或者直接点击 /pricing 站点地图
搭配使用: filesystem

编写带有实时验证链接的教程

👤 技术作家,DevRel ⏱ ~25 min intermediate

何时使用: 您正在发布操作方法,每个外部链接今天都必须解析为正确的内容。

步骤
  1. 收集候选人参考资料
    使用 tavilly_search,找到“OAuth 2.1 PKCE flow”的前 5 个规范文档页面。 与博客相比,更喜欢 RFC 和供应商文档。✓ 已复制
    → 5 个 URL,每个 URL 都有简短的理由
  2. 验证每一项
    tavilly_extract每个URL。 对于每个页面,确认页面仍然覆盖 PKCE 并标记任何看起来重定向或过时的页面。✓ 已复制
    → 每个 URL 的实时判决
  3. 嵌入草稿中
    重写我的教程草稿,仅引用经过验证的 URL,并使用与页面实际标题匹配的锚文本。✓ 已复制
    → 更新草案; 每个链接文本都与真实页面标题匹配

结果: 发布的教程具有零死链接和准确的锚文本。

搭配使用: filesystem

组合

与其他 MCP 搭配,撬动十倍杠杆

tavily-mcp + filesystem

搜索,提取到磁盘,然后在本地分析,无需重新获取

Tavilly 搜索最近的 OWASP 前 10 名来源,提取它们,保存到 /research/owasp/,然后离线比较内容。✓ 已复制
tavily-mcp + memory

建立一份在会议之间持续存在的研究期刊

对于每个 Tavily 搜索,将一行注释和 URL 保存到“project:acme”下的内存中。 下次会话,重复使用。✓ 已复制
tavily-mcp + context7

Tavilly 用于网络上下文 + Context7 用于库文档 - 不要混淆它们

使用 Context7 解决文档问题; 非常适合新闻、博客文章以及图书馆索引中没有的任何内容。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
tavily_search query: str, max_results?: int, search_depth?: 'basic'|'advanced', include_domains?: str[] 主要工具 — 一个查询、带有 URL 的 LLM 就绪片段 1 API call
tavily_extract urls: str[], extract_depth?: 'basic'|'advanced' 您已经有一个网址并且想要干净的文本 - 没有 HTML,没有广告 1 API call per URL
tavily_map url: str, max_depth?: int, categories?: str[] 发现网站的结构——在提取/抓取之前有用 1 API call
tavily_crawl url: str, max_depth?: int, limit?: int, instructions?: str 广泛摄取小网站或文档部分 - 昂贵,当您已经知道 URL 时更喜欢提取 Multiple API calls (one per page)

成本与限制

运行它的成本

API 配额
免费套餐 = 1,000 次 API 调用/月; 扩展计划从 30 美元/月起
每次调用 Token 数
返回大约 500–5000 个干净内容的标记 — 比原始 HTML 少得多
费用
免费套餐涵盖个人日常使用; 繁重的工作流程需要付费
提示
优先选择 tavilly_search 而不是 tavilly_crawl — 搜索是一次调用,爬行是 N 次。仅当您真正需要广度时才爬行。

安全

权限、密钥、影响范围

凭据存储: 环境变量中的 TAVILY_API_KEY(在 MCP 配置的环境块中设置)
数据出站: 您传递的查询和 URL 将发送到 api.tavily.com。 不要将专有信息粘贴到查询字符串中。

故障排查

常见错误与修复

401 未经授权

仔细检查 MCP 配置中的 TAVILY_API_KEY。 env 块位于服务器配置内部,而不是顶层。

验证: Call any Tavily tool; if the error persists, rotate the key in tavily.com dashboard
尽管进行了真正的查询,但结果为空

针对利基主题,将 search_depth 从“基本”切换为“高级”; 添加 include_domains 以偏向权威来源

验证: Repeat with search_depth: 'advanced'
tavily_extract 返回付费的乱码

Tavilly 遵循 robots.txt 并尊重付费专区。 对于付费内容,请注意它是无法访问的 - 不要尝试绕过。

429 速率限制

免费套餐 = 60 RPM。 间隔通话或在 tavilly.com 上升级。 MCP 自动后退一次,然后显示错误。

验证: Check usage in tavily.com dashboard

替代方案

Tavily MCP 对比其他方案

替代方案何时用它替代权衡
exa-mcp-server您想要 Exa 的神经/嵌入式搜索和相似性不同查询类型的结果质量不同; 两者均经过 LLM 调整
fetch您有 URL,只需要 HTML → markdown,无需搜索没有搜索; 无结构化提取物; 您处理 URL 发现
perplexity-ask您想要一个由 Perplexity 合成的研究级答案,而不是原始结果更高的延迟、更高的成本、更难组合——它是一个大工具
firecrawl-mcp-server您需要大量爬行或 JS 渲染作为核心工作流程价格较高; 对于一次性查找来说太过分了

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills