🔍 My Tavily Search MCP Agent

产品定位

Tavily Search MCP Agent 是一个基于 Tavily API 的 Model Context Protocol (MCP) 服务器，旨在通过开发者友好的接口提供高质量、可靠的信息，涵盖商业、新闻、金融和政治等领域。

核心功能

1. 性能与可靠性
2. 异步请求处理
3. 内置错误处理和自动重试
4. 可配置的请求超时

5. 全面的日志系统

6. 搜索配置

7. 可配置的搜索深度（基础/高级）
8. 可调整的结果限制（1-20个结果）
9. 干净的Markdown格式输出
10. 带有源URL的片段预览
11. 可选的图像结果

12. 专门的新闻搜索主题

13. 错误处理

14. API认证验证
15. 速率限制检测
16. 网络错误恢复
17. 请求超时管理

适用场景

1. 快速获取商业、新闻、金融和政治等领域的高质量信息
2. 开发者集成到自己的项目中，提供强大的搜索功能
3. 需要异步处理和自动重试的高可靠性搜索场景

工具列表

1. Tavily API：提供高质量、可靠的搜索功能
2. UV Package Manager：用于安装和管理依赖
3. Claude Desktop：优化集成的桌面客户端

常见问题解答

1. 连接问题
2. 验证配置路径
3. 检查Claude Desktop日志

4. 手动测试服务器

5. API问题

6. 验证API密钥权限
7. 检查网络连接
8. 监控服务器日志中的API响应

使用教程

使用依赖

1. Python 3.11或更高版本
2. UV Package Manager
3. Tavily API密钥

安装教程

1. 通过Smithery安装

npx -y @smithery/cli install mcp-tavily-search --client claude

1. 手动安装

# 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

调试方式

1. 运行测试

uv pip install -e ".[dev]"
pytest mcp_tavily_search

1. 检查日志

# Windows
type %APPDATA%\Claude\logs\latest.log
# Unix/MacOS
cat ~/.config/Claude/logs/latest.log

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。