# Tavily MCP MultiKey（中文说明）

[English](./README.md) | **中文**

本项目是 `tavily-mcp` 的一个增强版本（npm 包名：`tavily-mcp-multikey`），主要增加：
- 多 API Key 负载均衡与自动故障切换
- 使用统计（本地 JSON 持久化）与配额检查
- 可选的 webhook 回调（用于告警/定期报告等）

## 快速启动（推荐：NPX）

```bash
npx -y tavily-mcp-multikey@latest
```

启动前必须设置环境变量（二选一）：
- `TAVILY_API_KEYS=key1,key2,key3`（多 key，推荐）
- `TAVILY_API_KEY=key1`（单 key）

## MCP 客户端配置示例（Claude/Cline/VS Code 等）

```json
{
  "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](./README.md)
- 本仓库内还有更详细的指南（如果存在）：如 `USAGE_TRACKING_GUIDE.md`、`WEBHOOK_GUIDE.md`、`MULTI_CHANNEL_NOTIFICATIONS.md`
