tavily-mcp

环境要求

• 已安装 Node.js（npx 命令可用）
• 有效的 Tavily API Key（从 tavily.com 获取）
• 支持 MCP 的客户端，如 Claude、Cursor、Cline 等
• 可访问网络（本地运行或直连 mcp.tavily.com）

安装与启动步骤

1. 1获取 Tavily API Key

   前往 tavily.com 注册并生成 API Key，后续配置 MCP 或远程 URL 都要用到，请妥善保存。

2. 2用 npx 本地启动

   官方提供的本地启动方式，直接通过 npx 拉取并运行最新版 tavily-mcp，无需手动 clone 仓库。

   npx -y tavily-mcp@latest

   复制

3. 3写入客户端配置

   在 MCP 客户端的 mcp.json 里加入 tavily-mcp 配置块，command 用 npx，把 API Key 放进 env。

   {
     "mcpServers": {
       "tavily-mcp": {
         "command": "npx",
         "args": ["-y", "tavily-mcp@latest"],
         "env": {
           "TAVILY_API_KEY": "your-api-key-here"
         }
       }
     }
   }

   复制

4. 4或直连远程服务

   不想本地安装时，直接在客户端里填 Tavily 的远程 MCP 地址，把 API Key 作为查询参数拼在 URL 后。

   https://mcp.tavily.com/mcp/?tavilyApiKey=your-api-key-here

   复制

5. 5配置默认搜索参数

   通过 DEFAULT_PARAMETERS 环境变量为 tavily-search 设置默认值，省去每次请求重复传参；值为 JSON 字符串。

   export DEFAULT_PARAMETERS='{"include_images": true}'

   复制

6. 6可选：配置 OAuth 认证

   不想把 API Key 写进 URL 时，可用 mcp-remote 走 OAuth；需要重认证就删除本地凭据目录。

   rm -rf ~/.mcp-auth

   复制

关键配置

如何确认成功

在 MCP 客户端中看到 tavily-mcp 服务已连接，并列出 tavily-search、tavily-extract、map、crawl 等工具即可。

常见问题

注意事项

• API Key 属于敏感信息，不要提交到公开仓库或分享给他人。
• DEFAULT_PARAMETERS 的值为 JSON 字符串，写在 env 里时需要转义双引号。
• 远程 MCP 可直连官方服务，省去本地安装与配置成本。
• 本地运行依赖 npx，请确保 Node.js 环境已正确安装。