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