Tavily Mcp

Tavily Mcp

搜索 TypeScript

🚀 [Tavily MCP - 模型上下文协议服务器]

模型上下文协议（MCP）是一个开放标准，它能让AI系统与各种数据源和工具进行无缝交互，实现安全的双向连接。Tavily MCP服务器集成了先进搜索和数据提取功能，为AI模型提供实时网页信息访问。

GitHub Repo stars npm smithery badge

🎉 v0.2.1版本引入 tavily-crawl + tavily-map！ 🎉

模型上下文协议（MCP）由Anthropic开发，它使Claude等AI助手能够与Tavily的高级搜索和数据提取功能无缝集成。这种集成让AI模型能够实时访问网页信息，还具备复杂的过滤选项和特定领域的搜索功能。

Tavily MCP服务器提供以下功能：

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

📚 实用资源

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

🔧 先决条件

在开始之前，请确保您具备以下条件：

  • Tavily API密钥
    • 如果您没有Tavily API密钥，可以在此注册免费账户
  • Claude桌面版 或 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.2.1

通过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

要一键安装，请点击以下安装按钮之一：

Install with NPX in VS Code Install with NPX in VS Code Insiders

手动安装

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

将以下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@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服务器的最简单方法是通过市场一键完成：

  1. 在VS Code中打开Cline
  2. 点击侧边栏中的Cline图标
  3. 导航到“MCP Servers”选项卡（4个方块图标）
  4. 搜索“Tavily”并点击“install”
  5. 出现提示时，输入您的Tavily API密钥

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

  1. 打开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
  2. 将Tavily服务器配置添加到文件中： 将 your-api-key-here 替换为您的实际 Tavily API密钥。
    {
"mcpServers": {
"tavily-mcp": {
"command": "npx",
"args": ["-y", "tavily-mcp@0.2.1"],
"env": {
"TAVILY_API_KEY": "your-api-key-here"
},
"disabled": false,
"autoApprove": []
}
}
}
  3. 保存文件，如果Cline已经在运行，请重启它。
  4. 使用Cline时，您现在可以访问Tavily MCP工具。您可以在对话中直接要求Cline使用tavily-search和tavily-extract工具。

🖥️ 配置Cursor

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

要在Cursor中设置Tavily MCP服务器，请按照以下步骤操作：

  1. 打开Cursor设置
  2. 导航到Features > MCP Servers
  3. 点击“+ Add New MCP Server”按钮
  4. 填写以下信息：
    • 名称：为服务器输入一个昵称（例如，“tavily-mcp”）
    • 类型：选择“command”作为类型
    • 命令：输入运行服务器的命令：
      env TAVILY_API_KEY=your-api-key npx -y tavily-mcp@0.2.1

      重要：将 your-api-key 替换为您的Tavily API密钥。您可以在 app.tavily.com/home 获取一个。

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

Composer Agent将在与您的查询相关时自动使用Tavily MCP工具。最好通过描述您想要做的事情来明确请求使用这些工具（例如，“使用tavily-search搜索网络上关于AI的最新新闻”）。在Mac上，按command + L打开聊天窗口，选择屏幕顶部的composer选项，在提交按钮旁边选择agent，准备好后提交查询。

🖥️ 配置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@0.2.1"],
"env": {
"TAVILY_API_KEY": "your-api-key-here"
}
}
}
}

2. Git安装

  1. 克隆仓库：
git clone https://github.com/tavily-ai/tavily-mcp.git
cd tavily-mcp
  1. 安装依赖项：
npm install
  1. 构建项目：
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"
}
}
}
}

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

安装完成且Claude桌面应用程序配置好后，您必须完全关闭并重新打开Claude桌面应用程序才能看到tavily-mcp服务器。您应该会在应用程序左下角看到一个锤子图标，表示有可用的MCP工具，您可以点击锤子图标查看tavily-search和tavily-extract工具的更多详细信息。

现在Claude将可以完全访问tavily-mcp服务器，包括tavily-search和tavily-extract工具。如果您将以下示例插入Claude桌面应用程序中，您应该会看到tavily-mcp服务器工具的实际运行情况。

Tavily搜索示例

  1. 通用网络搜索：
能否搜索量子计算的最新发展情况？
  1. 新闻搜索：
搜索过去7天内关于AI初创公司的新闻文章。
  1. 特定领域搜索：
在nature.com和sciencedirect.com上搜索气候变化研究。

Tavily提取示例

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

✨ 结合搜索和提取 ✨

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

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

🛠️ 故障排除

常见问题

  1. 未找到服务器

    • 运行 npm --version 验证npm安装情况
    • 运行 code ~/Library/Application\ Support/Claude/claude_desktop_config.json 检查Claude桌面配置语法
    • 运行 node --version 确保Node.js已正确安装

  2. NPX相关问题

  • 如果您遇到与 npx 相关的错误，可能需要使用npx可执行文件的完整路径。
  • 您可以在终端中运行 which npx 找到此路径，然后在配置中将 "command": "npx" 行替换为 "command": "/full/path/to/npx"。
  1. API密钥问题
    • 确认您的Tavily API密钥有效
    • 检查API密钥是否在配置中正确设置
    • 验证API密钥周围没有空格或引号

✨ 致谢

默认排序 时间排序

0 个评论

  • 0 关注
  • 0 收藏，9 浏览
  • system 提出于 2025-09-23 12:30

相似服务问题

热议话题 »