背景Claude Code 通过 MCPModel 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 credit1 次 research 5 credits。对于日常开发需求来说完全够用。二、注册 Tavily访问 tavily.com → 点击Sign Up选择Free套餐1,000 credits/月无需绑定信用卡进入 Dashboard →API Keys→ 复制生成的 API key格式tvly-dev-xxxxxxxx三、配置 CcSwitch MCP推荐方式CcSwitch 使用 SQLite 数据库存储 MCP 配置数据库文件路径为~/.cc-switch/cc-switch.db。3.1 查看当前配置sqlSELECT 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 替换为新配置sqlUPDATE mcp_servers SET server_config { type: http, url: https://mcp.tavily.com/mcp/?tavilyApiKeytvly-YOUR_API_KEY, headers: {} } WHERE name tavily-proxy;主要变更URL 从astrdark.cyou/mcp切换为官方的mcp.tavily.com/mcpAPI 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/?tavilyApiKeytvly-YOUR_API_KEY } } }五、实测验证API key 有效性检查bashcurl -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 端点可用性检查bashcurl -s POST https://mcp.tavily.com/mcp/?tavilyApiKeytvly-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 中测试texttavily 搜索最新的 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 官方 MCPhttps://mcp.tavily.com/mcp如何修改更新 CcSwitch 数据库cc-switch.db→mcp_servers表API key 传递方式tvly-dev-xxx作为 URL 参数嵌入费用免费 1,000 credits/月相关资源Tavily 官网Tavily API 文档Tavily MCP 服务器