Tavily MCP 服务器支持代理

这是一个使用 Tavily 搜索 API 提供由 AI 支持的网络搜索功能的模型上下文协议服务器，并增加了对 HTTP/HTTPS 代理配置的支持。该服务器使 LLMs 能够通过代理服务器执行复杂的网络搜索，获取问题的直接答案，并搜索带有 AI 提取的相关内容的最新新闻文章。

特性

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

可用工具

• tavily_web_search - 使用 AI 支持的内容提取执行全面的网络搜索。

  • query (字符串, 必需): 搜索查询
  • max_results (整数, 可选): 返回的最大结果数量 (默认: 5, 最大: 20)
  • search_depth (字符串, 可选): "basic" 或 "advanced" 搜索深度 (默认: "basic")

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

  • query (字符串, 必需): 搜索查询
  • max_results (整数, 可选): 返回的最大结果数量 (默认: 5, 最大: 20)
  • search_depth (字符串, 可选): "basic" 或 "advanced" 搜索深度 (默认: "advanced")

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

  • query (字符串, 必需): 搜索查询
  • max_results (整数, 可选): 返回的最大结果数量 (默认: 5, 最大: 20)
  • days (整数, 可选): 向后搜索的天数 (默认: 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 密钥和代理设置

服务器需要一个 Tavily 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"
    }
  }
}

示例

对于常规搜索：

Tell me about Anthropic's newly released MCP protocol

生成包含显式排除项的报告：

Tell me about redwood trees. Please use MLA format in markdown syntax and include the URLs in the citations. Exclude Wikipedia sources.

对于新闻搜索：

Give me the top 10 AI-related news in the last 5 days

调试

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

export TAVILY_LOG_LEVEL=DEBUG
python -m mcp_server_tavily

你也可以使用 MCP 检查器：

npx @modelcontextprotocol/inspector python -m mcp_server_tavily

贡献

欢迎贡献！请随时提交拉取请求以帮助改进代理支持或添加新功能。

许可证

该项目根据 MIT 许可证授权 - 详情请参阅 LICENSE 文件。

致谢

本项目基于原始的 mcp-tavily，增加了代理支持功能。