塔维利-MCP

Name: 塔维利-MCP
Author: tavily-ai

作者：tavily-ai944 星标更新：2025-10-08

安装使用来源：spider==github.com

项目介绍

npm

MCP demo

Tavily MCP服务器提供：

搜索、提取、映射、爬取工具
通过tavily-search工具实现实时网络搜索功能
通过tavily-extract工具从网页中智能提取数据
强大的网络映射工具，创建网站的结构化地图
系统地探索网站的网络爬虫

📚 有用的资源

教程关于结合Tavily MCP与Neo4j MCP服务器
教程关于在VS Code中集成Tavily MCP与Cline

远程MCP服务器

直接连接到Tavily的远程MCP服务器而不是本地运行。这提供了无缝体验，无需本地安装或配置。

只需使用您的Tavily API密钥和远程MCP服务器URL：

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

从tavily.com获取您的Tavily API密钥。

或者，如果MCP客户端支持，您可以通过授权头传递您的API密钥：

Authorization: Bearer <your-api-key>

连接到Cursor

点击上方的“添加到Cursor”按钮，这将为您完成大部分工作，但您仍需编辑配置以添加您的API-KEY。您可以在这里获取Tavily API密钥：这里。

一旦点击按钮，您应该会被重定向到Cursor...

第一步

点击安装按钮

第二步

您应该看到MCP已安装，如果蓝色滑块尚未打开，请手动打开。您还需要编辑配置以包含您自己的Tavily API密钥。

第三步

然后您将被重定向到您的mcp.json文件，在那里您需要添加your-api-key。

{
  "mcpServers": {
    "tavily-remote-mcp": {
      "command": "npx -y mcp-remote https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>",
      "env": {}
    }
  }
}

连接到Claude桌面

Claude桌面现在支持添加integrations，目前处于测试阶段。在这种情况下，集成是Tavily远程MCP，下面我将解释如何在Claude桌面中将MCP作为integration添加。

第一步

打开Claude桌面，点击带有两个滑块的按钮，然后导航到添加集成。

第二步

点击添加集成

第三步

命名集成并插入Tavily远程MCP URL及您的API密钥。您可以在这里获取Tavily API密钥：这里。点击添加确认。

第四步

返回聊天界面，您会看到Tavily远程MCP已连接到Claude桌面。

OpenAI

允许模型使用远程MCP服务器执行任务。

您首先需要导出您的OPENAI_API_KEY
您还必须将您的Tavily API密钥添加到<your-api-key>中，您可以在这里获取Tavily API密钥：这里

from openai import OpenAI

client = OpenAI()

resp = client.responses.create(
    model="gpt-4.1",
    tools=[
        {
            "type": "mcp",
            "server_label": "tavily",
            "server_url": "https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>",
            "require_approval": "never",
        },
    ],
    input="您是否可以访问tavily mcp服务器？",
)

print(resp.output_text)

不支持远程MCP的客户端

mcp-remote是一个轻量级桥梁，让只能与本地（标准输入输出）服务器通信的MCP客户端能够通过HTTP + SSE和基于OAuth的身份验证安全连接到远程MCP服务器，因此您可以在云中托管和更新您的服务器，而现有客户端继续正常工作。它作为一个实验性的过渡措施，直到流行的MCP客户端原生支持远程、授权的服务器。

{
    "tavily-remote": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>"
      ]
    }
}

本地MCP

先决条件 🔧

开始之前，请确保您拥有以下内容：

Tavily API密钥
- 如果您没有Tavily API密钥，您可以在这里注册免费账户：这里
Claude桌面或 Cursor
Node.js（版本20或更高）
- 您可以通过运行以下命令来验证Node.js安装：
  - node --version
已安装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@latest

通过Smithery安装

要通过Smithery自动为Claude桌面安装Tavily MCP服务器：

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

虽然您可以单独启动一个服务器，但在孤立的情况下并不特别有用。相反，您应该将其集成到MCP客户端中。以下是配置Claude桌面应用程序以与tavily-mcp服务器一起工作的示例。

配置MCP客户端 ⚙️

本仓库将解释如何配置VS Code、Cursor和Claude桌面以与tavily-mcp服务器一起工作。

配置VS Code 💻

对于一键安装，点击下方其中一个安装按钮：

手动安装

首先检查本节顶部是否有符合您需求的安装按钮。如果您更喜欢手动安装，请按照以下步骤操作：

将以下JSON块添加到VS Code的用户设置（JSON）文件中。您可以通过按Ctrl + Shift + P（或在macOS上按Cmd + Shift + P），然后键入Preferences: Open User Settings (JSON)来做到这一点。

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "tavily_api_key",
        "description": "Tavily API Key",
        "password": true
      }
    ],
    "servers": {
      "tavily": {
        "command": "npx",
        "args": ["-y", "tavily-mcp@latest"],
        "env": {
          "TAVILY_API_KEY": "${input:tavily_api_key}"
        }
      }
    }
  }
}

可选地，您可以将其添加到工作区中的.vscode/mcp.json文件中：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "tavily_api_key",
      "description": "Tavily API Key",
      "password": true
    }
  ],
  "servers": {
    "tavily": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "${input:tavily_api_key}"
      }
    }
  }
}

配置Cline 🤖

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

在VS Code中打开Cline
点击侧边栏中的Cline图标
导航到"MCP服务器"标签（四个方块）
搜索"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@latest"],
      "env": {
        "TAVILY_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

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

配置Claude桌面应用 🖥️

对于macOS：

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

# 使用TextEdit打开配置文件
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@latest"],
      "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桌面应用 ⚙️

按照上述配置Claude桌面应用部分中的配置步骤进行操作，使用以下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"
      }
    }
  }
}

致谢 ✨

Model Context Protocol 提供了MCP规范
Anthropic 提供了Claude桌面