---

背景

Claude Code 通过 MCP（Model Context Protocol）服务器实现联网搜索。之前使用的自建代理 https://tavily.astrdark.cyou/mcp 已经失效（HTTP 521），导致搜索功能不可用。

本文将介绍如何直接接入 Tavily 官方 MCP 服务，每月提供 1,000 次免费搜索额度，无需依赖自建代理。

---

一、Tavily 简介

Tavily 是专为 AI Agent 设计的 Web 搜索 API，提供 5 个 MCP 工具：

工具	说明
tavily_search	实时搜索，支持时间范围、域名过滤、搜索深度等配置
tavily_extract	提取单个网页的完整内容（Markdown/纯文本格式）
tavily_crawl	递归爬取网站的所有页面
tavily_map	生成网站的 URL 结构地图
tavily_research	多页搜索 + 自动总结（深度研究模式，20次/分钟速率限制）

免费额度：1,000 credits/月。1 次 search = 1 credit，1 次 research = 5 credits。对于日常开发需求来说完全够用。

---

二、注册 Tavily

1. 访问 tavily.com → 点击 Sign Up

2. 选择 Free 套餐（1,000 credits/月，无需绑定信用卡）

3. 进入 Dashboard → API Keys → 复制生成的 API key（格式：tvly-dev-xxxxxxxx）

---

三、配置 CcSwitch MCP（推荐方式）

CcSwitch 使用 SQLite 数据库存储 MCP 配置，数据库文件路径为 ~/.cc-switch/cc-switch.db。

3.1 查看当前配置

sql

SELECT name, server_config FROM mcp_servers WHERE name LIKE '%tavily%';

旧配置内容：

json

{
  "type": "http",
  "url": "https://tavily.astrdark.cyou/mcp",
  "headers": {
    "Authorization": "Bearer xxx"
  }
}

3.2 替换为新配置

sql

UPDATE mcp_servers SET server_config = '{
  "type": "http",
  "url": "https://mcp.tavily.com/mcp/?tavilyApiKey=tvly-YOUR_API_KEY",
  "headers": {}
}' WHERE name = 'tavily-proxy';

主要变更：

• URL 从 astrdark.cyou/mcp 切换为官方的 mcp.tavily.com/mcp

• API key 直接作为 URL 参数传递（?tavilyApiKey=...）

• 不再需要 Authorization 请求头

3.3 重启 CcSwitch

配置修改后重启服务即可生效，Claude Code 将通过 CcSwitch 代理正常使用 Tavily 搜索功能。

---

四、配置 Claude Code 原生 MCP（备选方案）

如果不使用 CcSwitch，也可以直接在 Claude Code 中配置：

json

// ~/.claude/mcp.json
{
  "mcpServers": {
    "tavily": {
      "type": "url",
      "url": "https://mcp.tavily.com/mcp/?tavilyApiKey=tvly-YOUR_API_KEY"
    }
  }
}

---

五、实测验证

API key 有效性检查

bash

curl -s POST https://api.tavily.com/search \
  -H "Content-Type: application/json" \
  -d '{"api_key":"tvly-dev-xxx","query":"hello world","max_results":1}'
# ✅ 返回正常的搜索结果

MCP 端点可用性检查

bash

curl -s POST "https://mcp.tavily.com/mcp/?tavilyApiKey=tvly-dev-xxx" \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
# ✅ 返回全部 5 个工具的定义

在 Claude Code 中测试

text

@tavily 搜索最新的 AI agent 框架

---

六、常见问题

Q1：免费额度够用吗？

按日均使用量估算：每天 10 次搜索 × 30 天 = 300 credits，仍剩余 700 credits。即使使用深度研究（research）模式，每次消耗 5 credits，也可以使用 200 次。日常使用绰绰有余。

Q2：额度耗尽后如何处理？

• 等待每月 1 日自动重置额度

• 升级至 Pay As You Go 方案（$0.008/credit）

• 临时切换到 SearXNG 或 ddgs 等替代方案

Q3：为什么推荐使用 CcSwitch 而不是直接在 CC 中配置？

CcSwitch 可以统一管理多个 agent 的配置（包括 Claude Code、Codex、OpenCode、Hermes），修改一处即可让所有 agent 同步生效。

Q4：搜索质量如何？

官方基准测试（SimpleQA）准确率达到 80% 以上，明显优于 DuckDuckGo 等免费方案，中文搜索方面的表现尤其出色。

---

七、总结

问题	答案
旧代理失效原因	tavily.astrdark.cyou 源服务器宕机（Cloudflare 返回 521 错误）
新方案	Tavily 官方 MCP：https://mcp.tavily.com/mcp
如何修改	更新 CcSwitch 数据库 cc-switch.db → mcp_servers 表
API key 传递方式	tvly-dev-xxx 作为 URL 参数嵌入
费用	免费 1,000 credits/月

---

相关资源：

• Tavily 官网

• Tavily API 文档

• Tavily MCP 服务器