基本能力
产品定位
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
安装
bash
pip install mcp-tavily-proxy
或使用 uv
安装:
bash
uv pip install mcp-tavily-proxy
从源代码构建
克隆仓库并构建安装程序:
bash
git clone https://github.com/tulong66/mcp-tavily-proxy.git
cd mcp-tavily-proxy
uv build
uv pip install .
配置
API 密钥和代理设置
- 设置环境变量:
```bash
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
```
- 或通过命令行参数提供 API 密钥:
bash
python -m mcp_server_tavily --api-key=your_api_key_here
配置 Claude.app
添加到 Claude 设置中:
json
{
"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"
}
}
}
调试方式
启用调试日志以查看详细的代理配置信息:
bash
export TAVILY_LOG_LEVEL=DEBUG
python -m mcp_server_tavily
使用 MCP 检查器:
bash
npx @modelcontextprotocol/inspector python -m mcp_server_tavily