# StevenFengLi
## 基本信息
- Slug: `stevenfengli-tavily-mcp`
- Source: modelscope
- Publisher: @StevenFengLi/tavily-mcp
- Categories: browser-automation / web-scraping / search
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@StevenFengLi/tavily-mcp
## 简介
暂无描述。
## MCP Server 详情

# Tavily MCP 服务器 🚀

![GitHub Repo stars](https://img.shields.io/github/stars/tavily-ai/tavily-mcp?style=social)
![npm](https://img.shields.io/npm/dt/tavily-mcp)
![smithery badge](https://smithery.ai/badge/@tavily-ai/tavily-mcp)

> 🔌 **兼容 [Cline](https://github.com/cline/cline), [Cursor](https://cursor.sh), [Claude Desktop](https://claude.ai/desktop) 以及其他任何 MCP 客户端！**
>
> Tavily MCP 也与任何 MCP 客户端兼容
>
> 📚 结合 Tavily MCP 和 Neo4j MCP 服务器的[教程](https://medium.com/@dustin_36183/building-a-knowledge-graph-assistant-combining-tavily-and-neo4j-mcp-servers-with-claude-db92de075df9)!
> 
> 📚 在 VS Code 中将 Tavily MCP 与 Cline 集成的[教程](https://medium.com/@dustin_36183/connect-your-coding-assistant-to-the-web-integrating-tavily-mcp-with-cline-in-vs-code-5f923a4983d1) (演示 + 示例用例)
>

![Tavily MCP 演示](./assets/mcp-demo.gif)

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

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

Tavily MCP 服务器提供：
- 与 tavily-search 和 tavily-extract 工具的无缝交互
- 通过 tavily-search 工具实现的实时网络搜索能力
- 通过 tavily-extract 工具从网页中智能提取数据


## 先决条件 🔧

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

- [Tavily API 密钥](https://app.tavily.com/home)
  - 如果您还没有 Tavily API 密钥，可以在此处[注册](https://app.tavily.com/home)免费帐户
- [Claude Desktop](https://claude.ai/download) 或 [Cursor](https://cursor.sh)
- [Node.js](https://nodejs.org/) (v20 或更高版本)
  - 您可以通过运行以下命令来验证 Node.js 安装：
    - `node --version`
- [Git](https://git-scm.com/downloads) 安装（仅当使用 Git 安装方法时需要）
  - 在 macOS 上：`brew install git`
  - 在 Linux 上：
    - Debian/Ubuntu: `sudo apt install git`
    - RedHat/CentOS: `sudo yum install git`
  - 在 Windows 上：下载 [Git for Windows](https://git-scm.com/download/win)

## Tavily MCP 服务器安装 ⚡

### 使用 NPX 运行

bash
npx -y tavily-mcp@0.1.4  


### 通过 Smithery 安装

要通过 [Smithery](https://smithery.ai/server/@tavily-ai/tavily-mcp) 自动为 Claude Desktop 安装 Tavily MCP 服务器：

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


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


## 配置 MCP 客户端 ⚙️

本仓库将解释如何配置 [Cursor](https://cursor.sh) 和 [Claude Desktop](https://claude.ai/desktop) 以与 tavily-mcp 服务器一起工作。


### 配置 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:
   bash
   # 使用 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:
bash
code %APPDATA%CodeUserglobalStoragesaoudrizwan.claude-devsettingscline_mcp_settings.json


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

   将 `your-api-key-here` 替换为您的实际 [Tavily API 密钥](https://tavily.com/api-keys)。

   json
   {
     "mcpServers": {
       "tavily-mcp": {
         "command": "npx",
         "args": ["-y", "tavily-mcp@0.1.4"],
         "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. 导航至 功能 > MCP 服务器
3. 点击 "+ 添加新的 MCP 服务器" 按钮
4. 填写以下信息：
   - **名称**：输入服务器的昵称（例如："tavily-mcp"）
   - **类型**：选择 "命令" 作为类型
   - **命令**：输入运行服务器的命令：
     bash
     env TAVILY_API_KEY=your-api-key npx -y tavily-mcp@0.1.4
     
     > **重要**：将 `your-api-key` 替换为您的 Tavily API 密钥。您可以在 [app.tavily.com/home](https://app.tavily.com/home) 获取密钥

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

作曲家代理将在相关查询中自动使用 Tavily MCP 工具。最好通过描述您想做的事情明确请求使用这些工具（例如：“使用 tavily-search 搜索有关 AI 的最新新闻”）。在 Mac 上按 command + L 打开聊天，选择屏幕顶部的作曲家选项，在提交按钮旁边选择代理，并在准备好时提交查询。

![Cursor 界面示例](./assets/cursor-reference.png)

### 配置 Claude 桌面应用程序 🖥️
### 对于 macOS:

bash
# 如果配置文件不存在，则创建该文件
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:
bash
code %APPDATA%Claudeclaude_desktop_config.json


### 添加 Tavily 服务器配置：

将 `your-api-key-here` 替换为您的实际 [Tavily API 密钥](https://tavily.com/api-keys)。

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


### 2. Git 安装

1. 克隆仓库：
bash
git clone https://github.com/tavily-ai/tavily-mcp.git
cd tavily-mcp


2. 安装依赖项：
bash
npm install


3. 构建项目：
bash
npm run build

### 配置 Claude 桌面应用程序 ⚙️
按照上面 [配置 Claude 桌面应用程序](#configuring-the-claude-desktop-app-️) 部分概述的配置步骤进行操作，使用下面的 JSON 配置。

将 `your-api-key-here` 替换为您的实际 [Tavily API 密钥](https://tavily.com/api-keys)，并将 `/path/to/tavily-mcp` 替换为您系统上克隆仓库的实际路径。

json
{
  "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 工具的详细信息。

![Alt text](./assets/claude-desktop-ref.png)

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

### Tavily 搜索示例

1. **通用网络搜索**：

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


2. **新闻搜索**：

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


3. **特定领域搜索**：

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


### Tavily 提取示例

1. **提取文章内容**：

从这篇文章中提取主要内容：https…