Tavily MCP MultiKey（中文说明）

English | 中文

本项目是 tavily-mcp 的一个增强版本（npm 包名：tavily-mcp-multikey），主要增加：

• 多 API Key 负载均衡与自动故障切换
• 使用统计（本地 JSON 持久化）与配额检查
• 可选的 webhook 回调（用于告警/定期报告等）

快速启动（推荐：NPX）

npx -y tavily-mcp-multikey@latest

启动前必须设置环境变量（二选一）：

• TAVILY_API_KEYS=key1,key2,key3（多 key，推荐）
• TAVILY_API_KEY=key1（单 key）

MCP 客户端配置示例（Claude/Cline/VS Code 等）

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp-multikey@latest"],
      "env": {
        "TAVILY_API_KEYS": "tvly-abc123,tvly-def456",
        "USAGE_TRACKING_ENABLED": "true"
      }
    }
  }
}

使用统计（可选）

启用（最小配置）：

• USAGE_TRACKING_ENABLED=true

可选配置：

• USAGE_STATS_FILE=./usage-stats.json
• USAGE_CALLBACK_URL=<你的 webhook 地址>
• USAGE_REPORT_INTERVAL=3600
• USAGE_ALERT_THRESHOLD=80

说明

• README 的英文版包含更完整的配置/示例与细节说明：见 README.md
• 本仓库内还有更详细的指南（如果存在）：如 USAGE_TRACKING_GUIDE.md、WEBHOOK_GUIDE.md、MULTI_CHANNEL_NOTIFICATIONS.md