用 Cloudflare Workers 免费搭多Key聚合Tavily MCP代理

多个 Tavily API Key 合成一个池子，Claude、Cursor 等 AI 客户端共享使用，额度自动轮换、自动跳过耗尽的 Key，还能在网页上管理。

这是什么？

Tavily 是很好用的 AI 搜索 API，也提供 MCP 服务让 Claude、Cursor 直接调用搜索工具。但它每个 API Key 的搜索额度是独立的、有限的——一个 Key 不够用，分发给多个客户端又不放心。

这个项目把多个 Tavily Key 放进一个”池子”，统一暴露一个 MCP 地址。你只需要把它当成一个 Tavily MCP 来配置，实际调用会自动均匀地分摊到池子里所有 Key：

• 额度耗尽的 Key 自动跳过，下月自动恢复
• 被限流的 Key 自动冷却，换下一个
• 失效的 Key 自动剔除
• 一键在网页上添加 / 删除 / 查看所有 Key

部署（约 5 分钟）

前提：一个 Cloudflare 账号、一个或多个 Tavily API Key。

1. 打开项目仓库点 Deploy to Cloudflare Workers 一键部署（或本地 npx wrangler deploy）
2. 在 Cloudflare 控制台创建 KV namespace
3. 进入 Worker → Settings → Bindings，添加 KV 绑定，变量名填 KV，指向刚建的 namespace
4. Settings → Variables → 添加加密变量 AUTH_KEY（这是管理面板和 API 的登录口令，自定义一个）
5. 触发一次 Redeploy 让配置生效
6. 打开 https://你的worker地址/admin，输入 AUTH_KEY 登录，添加你的 Tavily Key，完工

全部在免费额度内即可运行，不花钱。

接入 AI 客户端

以 mcp-remote 为例（Cursor、Claude Desktop 通用）：

{
  "mcpServers": {
    "tavily-proxy": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://你的worker地址/mcp", "--header", "x-api-key:你的AUTH_KEY"]
    }
  }
}

配置完就能在客户端里用上搜索功能，池子里所有 Key 的额度共享给所有客户端。

日常怎么用

• 管理面板：浏览器打开 /admin，登录后能查看所有 Key 的状态（正常 / 耗尽 / 冷却中）、额度是否还有、添加/删除 Key、给 Key 写备注、手动同步额度。登录状态会记住，刷新不用重输。
• 添加 Key 时：可以顺手填个备注（比如”工作账号”、”朋友共享”），方便区分。
• 命令行管理（可选）：
  • 添加 Key：POST /api/keys，body 传 {"apiKey": "tvly-xxx"}
  • 看列表：GET /api/keys
  • 强制同步额度：POST /api/keys/sync
  • 删除：DELETE /api/keys
  • 除 /admin 和健康检查外，所有接口都要带 x-api-key: 你的AUTH_KEY 头。

常见问题

• 额度显示不准？ 额度只是展示用，实际健康度由 Tavily 返回的状态自动判定（432=耗尽、429=限流、401/403=失效），会自动处理。
• 工作区不在 Cloudflare？ 完全没关系，部署在 Cloudflare，任何客户端只要能访问 HTTPS 就行。
• Key 会被看到吗？ 面板和列表里 Key 都是掩码显示的，客户端拿到的也只是代理地址，看不到真实 Key。

---

项目地址：https://github.com/Tokisaki-Galaxy/tavily-proxy

觉得有用的话，欢迎 Star ⭐