test_20251222_online_update_01
Tavily MCP 服务器提供了搜索、提取、映射和爬取工具。它可以连接到各种客户端,如 VS Code、Cursor 和 Claude Desktop。该服务器可以本地运行或通过 Tavily API 密钥远程访问。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"tavily-mcp": {
"args": [
"-y",
"tavily-mcp@latest"
],
"command": "npx",
"env": {
"TAVILY_API_KEY": "your-api-key-here"
}
},
"tavily-remote-mcp": {
"command": "npx -y mcp-remote https://mcp.tavily.com/mcp/?tavilyApiKey=\u003cyour-api-key\u003e",
"env": {}
}
}
}
该服务需要配置环境变量:TAVILY_API_KEY
服务介绍

Tavily MCP 服务器提供:
- 搜索、提取、映射、爬取工具
- 通过 tavily-search 工具实现的实时网络搜索功能
- 通过 tavily-extract 工具从网页智能提取数据
- 强大的网络映射工具,可创建网站的结构化地图
- 系统地探索网站的网络爬虫
📚 有用的资源
远程 MCP 服务器
直接连接到 Tavily 的远程 MCP 服务器,而不是在本地运行。这提供了无缝体验,无需本地安装或配置。
只需使用您的 Tavily API 密钥和远程 MCP 服务器 URL:
https://mcp.tavily.com/mcp/?tavilyApiKey=
Get your Tavily API key from [tavily.com](https://www.tavily.com/).
Alternatively, you can pass your API key through an Authorization header if the MCP client supports this:
Authorization: Bearer
**Note:** When using the remote MCP, you can specify default parameters for all requests by including a `DEFAULT_PARAMETERS` header containing a JSON object with your desired defaults. Example:
```json
{"include_images":true, "search_depth": "basic", "max_results": 10}
连接到 Cursor
点击 ⬆️ 添加到 Cursor ⬆️ 按钮,这将为您完成大部分工作,但您仍然需要编辑配置以添加您的 API 密钥。您可以在此处获取 Tavily API 密钥 这里。
点击按钮后,您应该会被重定向到 Cursor ...
步骤 1
点击安装按钮

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

步骤 3
然后您将被重定向到 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 Desktop
Claude Desktop 现在支持添加 integrations,目前处于测试阶段。在这种情况下,集成是指 Tavily 远程 MCP,下面我将解释如何在 Claude Desktop 中将 MCP 作为 integration 添加。
步骤 1
打开 Claude Desktop,点击带有两个滑块的按钮,然后导航到添加集成。

步骤 2
点击 Add integrations

步骤 3
命名集成并插入带有您的 API 密钥的 Tavily 远程 MCP URL。您可以在此处获取 Tavily API 密钥 这里。点击 Add 确认。

步骤 4
返回聊天屏幕,您将看到 Tavily 远程 MCP 已连接到 Claude Desktop。

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="Do you have access to the tavily mcp server?",
)
print(resp.output_text)
不支持远程 MCP 的客户端
mcp-remote 是一个轻量级桥接器,允许只能与本地 (stdio) 服务器通信的 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 Desktop 或 Cursor
- Node.js(v20 或更高版本)
- 您可以通过运行以下命令验证 Node.js 安装:
node --version
- 您可以通过运行以下命令验证 Node.js 安装:
- Git 已安装(仅在使用 Git 安装方法时需要)
- 在 macOS 上:
brew install git - 在 Linux 上:
- Debian/Ubuntu:
sudo apt install git - RedHat/CentOS:
sudo yum install git
- Debian/Ubuntu:
- 在 Windows 上:下载 Git for Windows
- 在 macOS 上:
Tavily MCP 服务器安装 ⚡
使用 NPX 运行
npx -y tavily-mcp@latest
通过 Smithery 安装
要通过 Smithery 自动为 Claude Desktop 安装 Tavily MCP 服务器:
npx -y @smithery/cli install @tavily-ai/tavily-mcp --client claude
虽然您可以单独启动一个服务器,但这在孤立状态下并不是特别有用。相反,您应该将其集成到 MCP 客户端中。以下是如何配置 Claude Desktop 应用程序以与 tavily-mcp 服务器一起工作的示例。
配置 MCP 客户端 ⚙️
此仓库将解释如何配置 VS Code、Cursor 和 Claude Desktop 以与 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 Servers" 标签(4 个方块)
- 搜索 "Tavily" 并点击 "install"
- 当提示时,输入您的 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替换为您的实际 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。
-
使用 Cline 时,您现在可以访问 Tavily MCP 工具。您可以在对话中直接要求 Cline 使用 tavily-search 和 tavily-extract 工具。
配置 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 替换为您的实际 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 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"
}
}
}
}
默认参数配置 ⚙️
您可以使用 DEFAULT_PARAMETERS 环境变量为 tavily-search 工具设置默认参数值。这使您能够在不每次请求都指定这些参数的情况下配置默认搜索行为。
示例配置
export DEFAULT_PARAMETERS='{"include_images": true}'
从客户端示例使用
{
"mcpServers": {
"tavily-mcp": {
"command": "npx",
"args": ["-y", "tavily-mcp@latest"],
"env": {
"TAVILY_API_KEY": "your-api-key-here",
"DEFAULT_PARAMETERS": "{\"include_images\": true, \"max_results\": 15, \"search_depth\": \"advanced\"}"
}
}
}
}
致谢 ✨
- Model Context Protocol 提供了 MCP 规范
- Anthropic 提供了 Claude Desktop