使用说明

🎉 推出笨拙的爬行 + tavily-地图在v0.2.1版本中！ 🎉

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

由Anthropic开发的模型上下文协议（MCP）使像Claude这样的人工智能助手能够与Tavily的高级搜索和数据提取功能无缝集成。这种集成为人工智能模型提供了对网络信息的实时访问，并配有复杂的过滤选项和特定领域的搜索功能。

Tavily MCP服务器提供：

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

📚 有用的资源

教程 Tavily MCP与Neo4j MCP服务器的结合
教程 VS代码中Tavily MCP与Cline的集成

先决条件🔧

在开始之前，请确保您已经：

Tavilly API密钥
- 如果您没有Tavily API密钥，您可以注册一个免费帐户这里
克劳德桌面或光标
Node.js （v20或更高）
- 您可以通过运行以下命令来验证您的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@0.2.1

通过Smithery安装

通过以下方式自动安装Tavily MCP Server for Claude Desktop 史密瑟里:

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

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

配置MCP客户端⚙️

此存储库将解释如何配置 VS代码, 光标和克劳德桌面使用tavily mcp服务器。

配置VS代码💻

对于一键安装，请单击下面的安装按钮之一：

手动安装

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

将以下JSON块添加到VS Code中的用户设置（JSON）文件中。您可以按 Ctrl + Shift + P （或 Cmd + Shift + P 在macOS上）和键入 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@0.2.1"],
        "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@0.2.1"],
      "env": {
        "TAVILY_API_KEY": "${input:tavily_api_key}"
      }
    }
  }
}

配置Cline🤖

在Cline中设置Tavily MCP服务器的最简单方法是单击一下市场：

在VS代码中打开Cline
点击侧边栏中的Cline图标
导航到“MCP服务器”选项卡（4个方块）
搜索“Tavily”并单击“安装”
提示时，输入Tavily API密钥

或者，您可以在Cline中手动设置Tavily MCP服务器：

打开Cline MCP设置文件：

对于macOS：

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

# Or using 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 与你的实际 Tavilly API密钥.

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

保存文件并重新启动Cline（如果它已经在运行）。
使用Cline时，您现在可以访问Tavily MCP工具。您可以要求Cline在对话中直接使用两种搜索和两种提取工具。

配置光标🖥️

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

在Cursor中设置Tavily MCP服务器：

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

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

Composer Agent将在与您的查询相关时自动使用Tavily MCP工具。最好通过描述你想做什么来明确要求使用这些工具（例如，“用户不断搜索以在网络上搜索有关人工智能的最新消息”）。在mac上按command+L打开聊天，选择屏幕顶部的composer选项，在提交按钮旁边选择代理，并在准备就绪时提交查询。

配置Claude Desktop应用程序🖥️

对于macOS：

# Create the config file if it doesn't exist
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Opens the config file in TextEdit 
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Alternative method using Visual Studio Code (requires VS Code to be installed)
code "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

对于Windows：

code %APPDATA%\Claude\claude_desktop_config.json

添加Tavily服务器配置：

替换 your-api-key-here 与你的实际 Tavilly API密钥.

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@0.2.1"],
      "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 与你的实际 Tavilly 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桌面应用程序中的使用🎯

一旦安装完成，并且配置了Claude桌面应用程序，您必须完全关闭并重新打开Claude桌面程序才能看到tavily mcp服务器。您应该在应用程序的左下角看到一个锤子图标，指示可用的MCP工具，您可以单击锤子图标查看更多关于两次搜索和两次提取工具的详细信息。

现在，claude将可以完全访问tavily mcp服务器，包括tavily搜索和tavily提取工具。如果你将以下示例插入到Claude桌面应用程序中，你应该会看到tavily mcp服务器工具正在运行。

Tavily搜索示例

一般网络搜索:

Can you search for recent developments in quantum computing?

新闻搜索:

Search for news articles about AI startups from the last 7 days.

特定域搜索:

Search for climate change research on nature.com and sciencedirect.com

Tavily提取物示例

摘录文章内容:

Extract the main content from this article: https://example.com/article

✨ 结合搜索和提取✨

您还可以结合两种搜索和两种提取工具来执行更复杂的任务。

Search for news articles about AI startups from the last 7 days and extract the main content from each article to generate a detailed report.

故障排除🛠️

常见问题

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

如果您遇到与以下内容相关的错误 npx，您可能需要使用npx可执行文件的完整路径。
你可以通过跑步找到这条路 which npx 在您的终端中，然后更换 "command": "npx" 带有 "command": "/full/path/to/npx" 在您的配置中。

API关键问题
- 确认您的Tavily API密钥有效
- 检查配置中是否正确设置了API密钥
- 验证API键周围没有空格或引号

致谢✨

模型上下文协议对于MCP规范
Anthropic 克劳德桌面

使用说明

🎉 推出 笨拙的爬行 + tavily-地图 在v0.2.1版本中！ 🎉

📚 有用的资源

先决条件🔧

Tavily MCP服务器安装⚡

使用NPX运行

通过Smithery安装

配置MCP客户端⚙️

配置VS代码💻

手动安装

配置Cline🤖

对于macOS：

对于Windows：

配置光标🖥️

配置Claude Desktop应用程序🖥️

对于macOS：

对于Windows：

添加Tavily服务器配置：

2.Git安装

配置Claude Desktop应用程序⚙️

在Claude桌面应用程序中的使用🎯

Tavily搜索示例

Tavily提取物示例

✨ 结合搜索和提取✨

故障排除🛠️

常见问题

致谢✨

相关 MCP

小红书MCP服务

Figma MCP集成工具

MCP 协议测试服务器

Flomo笔记服务

Unity编辑器AI集成插件

网页数据提取 MCP 服务

🎉 推出笨拙的爬行 + tavily-地图在v0.2.1版本中！ 🎉