产品定位
Tavily Search MCP Agent 是一个基于 Tavily API 的 Model Context Protocol (MCP) 服务器，旨在通过开发者友好的接口提供高质量、可靠的信息，涵盖商业、新闻、金融和政治等领域。
核心功能
- 性能与可靠性
- 异步请求处理
- 内置错误处理和自动重试
- 可配置的请求超时
-
全面的日志系统
-
搜索配置
- 可配置的搜索深度（基础/高级）
- 可调整的结果限制（1-20个结果）
- 干净的Markdown格式输出
- 带有源URL的片段预览
- 可选的图像结果
-
专门的新闻搜索主题
-
错误处理
- API认证验证
- 速率限制检测
- 网络错误恢复
- 请求超时管理
适用场景
- 快速获取商业、新闻、金融和政治等领域的高质量信息
- 开发者集成到自己的项目中，提供强大的搜索功能
- 需要异步处理和自动重试的高可靠性搜索场景
工具列表
- Tavily API：提供高质量、可靠的搜索功能
- UV Package Manager：用于安装和管理依赖
- Claude Desktop：优化集成的桌面客户端
常见问题解答
- 连接问题
- 验证配置路径
- 检查Claude Desktop日志
-
手动测试服务器
-
API问题
- 验证API密钥权限
- 检查网络连接
- 监控服务器日志中的API响应
使用教程
使用依赖
- Python 3.11或更高版本
- UV Package Manager
- Tavily API密钥
安装教程
-
通过Smithery安装
bash
npx -y @smithery/cli install mcp-tavily-search --client claude -
手动安装
```bash
1. 创建环境
uv venv && .venv\Scripts\activate # Windows
OR
uv venv && source .venv/bin/activate # Unix/MacOS
2. 安装依赖
uv pip install -e .
3. 设置配置
echo TAVILY_API_KEY=your-key-here > .env
4. 启动服务器
cd mcp_tavily_search && uv run server.py
```
调试方式
-
运行测试
bash
uv pip install -e ".[dev]"
pytest mcp_tavily_search -
检查日志
```bash
Windows
type %APPDATA%\Claude\logs\latest.log
Unix/MacOS
cat ~/.config/Claude/logs/latest.log
```
