Tavily MCP Server (Custom Fork)

基于 tavily-ai/tavily-mcp 的定制分支，增加了 TAVILY_BASE_URL 支持，可将所有 API 请求重定向到自定义代理服务器，用于访问日志记录、审计或调试。

与上游的区别

• 新增 TAVILY_BASE_URL 环境变量，可覆盖默认的 https://api.tavily.com 端点
• 启动时会在 stderr 输出当前使用的 base URL（仅在非默认值时）
• 其余功能与上游完全一致

部署方式

通过 npm 安装，开箱即用：

npx -y @shiharu/tavily-mcp@latest

MCP 客户端配置：

{
  "mcpServers": {
    "tavily": {
      "command": "npx",
      "args": ["-y", "@shiharu/tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "tvly-xxxxx",
        "TAVILY_BASE_URL": "https://your-proxy.example.com"
      }
    }
  }
}

不设置 TAVILY_BASE_URL 时行为与官方版本完全一致。

环境变量

| 变量 | 必填 | 说明 | |------|------|------| | TAVILY_API_KEY | 是 | Tavily API 密钥，从 tavily.com 获取 | | TAVILY_BASE_URL | 否 | 自定义 API 基础地址，默认 https://api.tavily.com | | DEFAULT_PARAMETERS | 否 | JSON 格式的默认搜索参数 |

所有请求（search / extract / crawl / map / research）都会发往 TAVILY_BASE_URL 下对应的路径，例如 https://your-proxy.example.com/search。

本地开发

git clone https://github.com/shiharuharu/tavily-mcp.git
cd tavily-mcp
git checkout custom/base-url-proxy
npm install && npm run build

同步上游更新

git fetch upstream
git merge upstream/main

可用工具

• tavily_search — 实时网页搜索
• tavily_extract — 从 URL 提取内容
• tavily_crawl — 网站爬取
• tavily_map — 网站结构映射
• tavily_research — 综合研究

许可证

MIT（继承自上游）