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,两个新工具即可使用:
| 原工具 | 平替工具 | 说明 |
|---|---|---|
WebSearch | mcp__tavily-remote-mcp__tavily-search | 网页搜索,支持深度模式、域名过滤、时间范围 |
WebFetch | mcp__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