Tavily MCP:Claude Code WebSearch/WebFetch 的平替方案
2026/8/3 12:06:56 网站建设 项目流程

Tavily MCP:Claude Code WebSearch/WebFetch 的平替方案

为什么需要平替

Claude Code 内置的 WebSearch 和 WebFetch仅限美国地区可用。中国大陆用户调用时会直接报错或无返回,等于这两个工具形同虚设。Tavily MCP 提供了同等能力的搜索(tavily-search)和网页提取(tavily-extract),且无地域限制,是最佳替代。

配置方法

1. 获取 API Key

前往 tavily.com 注册账号,在 Dashboard 生成 API Key(格式tvly-...)。免费额度每月 1000 次搜索。

2. 配置 MCP Server

在项目.claude/.claude.json或全局~/.claude/.claude.json中添加:

{"mcpServers":{"tavily-remote-mcp":{"type":"stdio","command":"npx","args":["-y","tavily-mcp@0.1.3"],"env":{"TAVILY_API_KEY":"tvly-your-api-key-here"}}}}

或者不写 env,直接设置环境变量:

PowerShell(当前会话)

$env:TAVILY_API_KEY = "tvly-your-api-key-here"

或永久设置(系统环境变量)

[System.Environment]::SetEnvironmentVariable("TAVILY_API_KEY", "tvly-your-api-key-here", "User")

3. 可选:默认参数

在 env 中加DEFAULT_PARAMETERS控制搜索行为:

"env":{"TAVILY_API_KEY":"tvly-your-api-key-here","DEFAULT_PARAMETERS":"{\"search_depth\": \"advanced\", \"max_results\": 10, \"include_images\": false}"}

4. 也可以用命令行添加

claude mcp add tavily-remote-mcp -- npx -y mcp-remote https://mcp.tavily.com/mcp

使用方式

配置完成后重启 Claude Code,两个新工具即可使用:

原工具平替工具说明
WebSearchmcp__tavily-remote-mcp__tavily-search网页搜索,支持深度模式、域名过滤、时间范围
WebFetchmcp__tavily-remote-mcp__tavily-extract网页内容提取,支持批量 URL

在 CLAUDE.md 中声明偏好

为了让 Claude Code 自动优先使用 Tavily,在 CLAUDE.md 中加:

Web Search & Extraction

  • 网页检索优先使用mcp__tavily-remote-mcp__tavily-search,而非 WebSearch
  • 网页内容提取优先使用mcp__tavily-remote-mcp__tavily-extract,而非 WebFetch
  • 仅在 Tavily MCP 不可用或失败时,才回退到 WebSearch / WebFetch

参考

  • Tavily MCP 官方文档

  • Tavily MCP GitHub

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询