支持代理的 Tavily MCP 服务器

一个模型上下文协议服务器，它使用 Tavily 的搜索 API 提供 AI 驱动的网页搜索功能，并增加了对 HTTP/HTTPS 代理配置的支持。该服务器使 LLM 能够通过代理服务器执行复杂的网页搜索，直接获得问题的答案，并搜索包含 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 密钥
export TAVILY_API_KEY=your_api_key_here

# 代理设置 (如果需要)
export HTTP_PROXY=http://your-proxy:port
export HTTPS_PROXY=http://your-proxy:port

2. 或者提供 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"
    }
  }
}

示例

对于常规搜索：

告诉我 Anthropic 新发布的 MCP 协议

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

告诉我关于红杉树的信息。请使用 MLA 格式的 markdown 语法，并在引文中包含 URL。排除维基百科来源。

对于新闻搜索：

给我过去 5 天内排名前 10 的 AI 相关新闻

调试

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

export TAVILY_LOG_LEVEL=DEBUG
python -m mcp_server_tavily

您还可以使用 MCP 检查器：

npx @modelcontextprotocol/inspector python -m mcp_server_tavily

贡献

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

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

致谢

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