tavily-mcp-proxy

Tavily MCP Proxy - Search via Tavily MCP with multiple keys, randomly selecting one each time.

通过 Tavily MCP 进行搜索，支持配置多个 API Key，每次调用随机选取一个。

Features / 功能

• 🐳 Docker-deployable Streamable HTTP MCP server / 支持 Docker 部署的 Streamable HTTP MCP 服务
• 🔑 Multiple Tavily API keys with random rotation / 多 Tavily API Key 随机轮换
• 🔒 Bearer token authentication for access control / Bearer Token 访问认证
• 🔍 tavily_search and tavily_extract tools / 包含 tavily_search 和 tavily_extract 两个工具

Quick Start / 快速开始

git clone https://github.com/welyfun/tavily-mcp-proxy.git
cd tavily-mcp-proxy

Create a .env file or configure environment variables / 创建 .env 文件或配置环境变量

TAVILY_API_KEYS=tvly-xxx,tvly-yyy,tvly-zzz
ACCESS_KEYS=my-secret-key
PORT=3000

Generate a secure access key / 生成一个安全的访问密钥:

python3 generate-key.py

Docker

docker compose up -d

Local Dev / 本地开发

npm install
npm run dev

Configuration / 配置项

Variable	Required	Description
TAVILY_API_KEYS	Yes	Tavily API keys, comma-separated / Tavily API Key，逗号分隔
ACCESS_KEYS	No	Access keys for authentication, comma-separated. Omit to disable auth / 访问密钥，逗号分隔。留空则不校验
PORT	No	Server port, default 3000 / 服务端口，默认 3000

Tools / 工具

tavily_search

Search the web using Tavily Search API. The query is forwarded with max_results fixed at 10. Metadata fields (response_time, usage, request_id, etc.) are stripped from the response.

使用 Tavily Search API 搜索网页。max_results 固定为 10，响应中已剔除元数据字段。

Parameter	Type	Required	Description
query	string	Yes	Search query / 搜索关键词

tavily_extract

Extract web page content from one or more URLs using Tavily Extract API. Metadata fields are stripped from the response.

使用 Tavily Extract API 提取网页内容。响应中已剔除元数据字段。

Parameter	Type	Required	Description
urls	string | string[]	Yes	URL(s) to extract / 要提取的 URL

Client Configuration / 客户端配置

Claude Desktop

{
  "mcpServers": {
    "tavily": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer my-secret-key"
      }
    }
  }
}

Codex

[mcp_servers.tavily]
url = "http://localhost:3000/mcp"
http_headers = { "Authorization" = "Bearer my-secret-key" }
default_tools_approval_mode = "approve"

License

MIT