Tavily MCP Server with Proxy Support

基本能力

产品定位

mcp-tavily-proxy 是一个 AI 驱动的网络搜索服务，支持代理配置，适用于需要通过代理进行网络搜索的场景。

核心功能

• 支持 Tavily 搜索 API 的所有原始功能
• 通过环境变量支持 HTTP/HTTPS 代理配置
• 增强的代理配置日志记录
• 针对代理相关问题的健壮错误处理

适用场景

• 需要通过代理进行网络搜索的应用
• 需要获取直接答案和搜索近期新闻的应用
• 需要 AI 提取相关内容的搜索场景

工具列表

• tavily_web_search：执行全面的网络搜索，带有 AI 提取的内容。
• query (string, required): 搜索查询
• max_results (integer, optional): 返回的最大结果数（默认：5，最大：20）

• search_depth (string, optional): "basic" 或 "advanced" 搜索深度（默认："basic"）

• tavily_answer_search：执行网络搜索并生成带有支持证据的直接答案。

• query (string, required): 搜索查询
• max_results (integer, optional): 返回的最大结果数（默认：5，最大：20）

• search_depth (string, optional): "basic" 或 "advanced" 搜索深度（默认："advanced"）

• tavily_news_search：搜索带有发布日期的近期新闻文章。

• query (string, required): 搜索查询
• max_results (integer, optional): 返回的最大结果数（默认：5，最大：20）
• days (integer, optional): 搜索的天数（默认：3）

使用教程

使用依赖

无特殊依赖，直接安装即可。

安装教程

使用 pip 安装

pip install mcp-tavily-proxy

或使用 uv 安装：

uv pip install mcp-tavily-proxy

从源代码构建

克隆仓库并构建安装程序：

git clone https://github.com/tulong66/mcp-tavily-proxy.git
cd mcp-tavily-proxy
uv build
uv pip install .

配置

API 密钥和代理设置

1. 设置环境变量：

# Tavily API Key
export TAVILY_API_KEY=your_api_key_here

# Proxy Settings (if needed)
export HTTP_PROXY=http://your-proxy:port
export HTTPS_PROXY=http://your-proxy:port

1. 或通过命令行参数提供 API 密钥：

python -m mcp_server_tavily --api-key=your_api_key_here

配置 Claude.app

添加到 Claude 设置中：

{
  "mcpServers": {
    "tavily": {
      "command": "python",
      "args": ["-m", "mcp_server_tavily"]
    },
    "env": {
      "TAVILY_API_KEY": "your_api_key_here",
      "HTTP_PROXY": "http://your-proxy:port",
      "HTTPS_PROXY": "http://your-proxy:port"
    }
  }
}

调试方式

启用调试日志以查看详细的代理配置信息：

export TAVILY_LOG_LEVEL=DEBUG
python -m mcp_server_tavily

使用 MCP 检查器：

npx @modelcontextprotocol/inspector python -m mcp_server_tavily

许可证

该项目遵循 MIT 开源许可条款。