Tavily MCP 服务器 🚀

🔌 兼容 Cline, Cursor, Claude Desktop 和任何其他 MCP 客户端！

Tavily MCP 也与任何 MCP 客户端兼容

📚 教程关于将 Tavily MCP 与 Neo4j MCP 服务器结合使用！

📚 教程在 VS Code 中将 Tavily MCP 与 Cline 集成（演示 + 示例用例）

模型上下文协议（MCP）是一个开放标准，允许 AI 系统与各种数据源和工具无缝交互，促进安全的双向连接。

由 Anthropic 开发，模型上下文协议（MCP）使得像 Claude 这样的 AI 助手能够无缝集成 Tavily 的先进搜索和数据提取功能。这个集成使得 AI 模型能够实时访问网络信息，并提供复杂的筛选选项和领域特定的搜索功能。

Tavily MCP 服务器提供：

与 tavily-search 和 tavily-extract 工具的无缝交互
通过 tavily-search 工具提供实时网页搜索能力
通过 tavily-extract 工具提供智能网页数据提取

安装前提 🔧

在开始之前，确保你拥有：

Tavily API 密钥
- 如果没有 Tavily API 密钥，你可以在这里注册一个免费账户
Claude Desktop 或 Cursor
Node.js（v20 或更高版本）
- 你可以通过运行：
  - node --version 来验证你的 Node.js 安装
安装 Git（如果你使用 Git 安装方法的话）
- macOS: brew install git
- Linux:
  - Debian/Ubuntu: sudo apt install git
  - RedHat/CentOS: sudo yum install git
- Windows: 下载 Git for Windows

Tavily MCP 服务器安装 ⚡

使用 NPX 运行

npx -y tavily-mcp@0.1.4

通过 Smithery 安装

要通过 Smithery 自动安装 Tavily MCP 服务器：

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

虽然你可以单独启动服务器，但这并不是特别有用。你应该将它集成到 MCP 客户端中。下面是如何配置 Claude Desktop 应用程序使其与 tavily-mcp 服务器一起使用的示例。

配置 MCP 客户端 ⚙️

本仓库将解释如何配置 Cursor 和 Claude Desktop 与 tavily-mcp 服务器一起使用。

配置 Cline 🤖

在 Cline 中设置 Tavily MCP 服务器最简单的方法是通过市场的一键安装：

在 VS Code 中打开 Cline
点击侧边栏中的 Cline 图标
导航到 "MCP Servers" 标签页（4个方块）
搜索 "Tavily" 并点击 "安装"
提示时，输入你的 Tavily API 密钥

你也可以手动在 Cline 中设置 Tavily MCP 服务器：

打开 Cline MCP 设置文件：

macOS：

# 使用 Visual Studio Code
code ~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

# 或使用 TextEdit
open -e ~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Windows：

code %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

将 Tavily 服务器配置添加到文件中：

将 your-api-key-here 替换为你的实际 Tavily API 密钥。

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

保存文件并重新启动 Cline（如果已经运行）。
使用 Cline 时，你现在可以访问 Tavily MCP 工具。你可以要求 Cline 在对话中直接使用 tavily-search 和 tavily-extract 工具。

配置 Cursor 🖥️

注意：需要 Cursor 版本 0.45.6 或更高版本

要在 Cursor 中设置 Tavily MCP 服务器：

打开 Cursor 设置
导航到功能 > MCP 服务器
点击 "+ 添加新的 MCP 服务器" 按钮
填写以下信息：
- 名称：输入服务器的昵称（例如，"tavily-mcp"）
- 类型：选择 "命令" 类型
- 命令：输入运行服务器的命令：
```
env TAVILY_API_KEY=your-api-key npx -y tavily-mcp@0.1.4
```
  重要：将 your-api-key 替换为你的 Tavily API 密钥。你可以在 app.tavily.com/home 获取。

添加服务器后，它应出现在 MCP 服务器列表中。你可能需要手动按右上角的刷新按钮，以填充工具列表。

Composer Agent 会在查询相关时自动使用 Tavily MCP 工具。最好通过描述你想要做的事情来明确请求使用这些工具（例如，"使用 tavily-search 搜索关于 AI 的最新新闻"）。在 mac 上按 command + L 打开聊天，选择屏幕顶部的 composer 选项，在提交按钮旁边选择代理并提交查询。

配置 Claude Desktop 应用 🖥️

对于 macOS：

# 如果文件不存在，创建配置文件
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# 打开配置文件以进行编辑
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# 使用 Visual Studio Code 的替代方法（需要安装 VS Code）
code "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

对于 Windows：

code %APPDATA%\Claude\claude_desktop_config.json

添加 Tavily 服务器配置：

将 your-api-key-here 替换为你的实际 Tavily API 密钥。

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

2. Git 安装

克隆仓库：

git clone https://github.com/tavily-ai/tavily-mcp.git
cd tavily-mcp

安装依赖：

npm install

构建项目：

npm run build

配置 Claude Desktop 应用 ⚙️

按照配置 Claude Desktop 应用部分的配置步骤，使用以下 JSON 配置。

将 your-api-key-here 替换为你的实际 Tavily API 密钥，并将 /path/to/tavily-mcp 替换为你在系统中克隆的仓库的实际路径。

{
          "mcpServers": {
            "tavily": {
              "command": "npx",
              "args": [
                "/path/to/tavily-mcp/build/index.js"
              ],
              "env": {
                "TAVILY_API_KEY": "your-api-key-here"
              }
            }
          }
        }

在 Claude Desktop 应用中使用 🎯

安装完成并配置好 Claude Desktop 应用后，你必须完全关闭并重新打开 Claude Desktop 应用，以便看到 tavily-mcp 服务器。你应该在应用的左下角看到一个锤子图标，表示可用的 MCP 工具，你可以点击该图标查看 tavily-search 和 tavily-extract 工具的更多细节。

现在 Claude 将完全访问 tavily-mcp 服务器，包括 tavily-search 和 tavily-extract 工具。如果你将下面的示例输入到 Claude Desktop 应用中，你应该会看到 tavily-mcp 服务器工具在工作。

Tavily 搜索示例

一般网络搜索：

你能搜索量子计算领域的最新进展吗？

新闻搜索：

搜索过去 7 天内关于 AI 初创公司的新闻文章。

特定领域搜索：

搜索 nature.com 和 sciencedirect.com 上的气候变化研究

Tavily 提取示例

提取文章内容：

提取这篇文章的主要内容：https://example.com/article

✨ 结合搜索和提取 ✨

你还可以结合使用 tavily-search 和 tavily-extract 工具来执行更复杂的任务。

搜索过去 7 天内关于 AI 初创公司的新闻文章，并提取每篇文章的主要内容以生成详细报告。

故障排除 🛠️

常见问题

找不到服务器
- 通过运行 npm --verison 验证 npm 安装
- 通过运行
```
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
```
  检查 Claude Desktop 配置语法
- 通过运行 node --version 确保 Node.js 安装正确
NPX 相关问题

如果遇到与 npx 相关的错误，可能需要使用 npx 可执行文件的完整路径。

tavily-mcp