支持代理的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密钥
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格式并包含URL引用。排除维基百科来源。

对于新闻搜索：

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

调试

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

export TAVILY_LOG_LEVEL=DEBUG
python -m mcp_server_tavily

你也可以使用MCP检查器：

npx @modelcontextprotocol/inspector python -m mcp_server_tavily

贡献

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

许可证

本项目根据MIT许可证授权 - 查看LICENSE文件了解详情。

致谢

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