返回 MCP 目录
public公开dns本地运行

github-9a2

Tavily MCP服务器是一个基于Model Context Protocol(MCP)的开源工具,为AI系统如Claude提供实时网络搜索和数据提取能力。它支持与多种MCP客户端(如Cline、Cursor和Claude Desktop)无缝集成,使AI助手能够访问Tavily的高级搜索和内容提取功能。

article

README

🚀 Tavily-MCP 项目文档

Tavily-MCP 是一个实用的项目,可帮助用户在 Claude 桌面应用中集成相关功能,实现网络搜索、内容提取等操作,提升使用效率。

🚀 快速开始

Tavily-MCP 可通过 npm 或手动克隆仓库的方式进行安装,安装完成后进行相应配置即可在 Claude 桌面应用中使用。

📦 安装指南

1. 使用 npm 安装

步骤 1: 安装依赖

在终端或命令提示符中运行以下命令以安装 Tavily-MCP:

npm install tavily-mcp

步骤 2: 启动服务器

成功安装后,启动 Tavily-MCP 服务器:

tavily-mcp start

2. 手动安装

步骤 1: 克隆仓库

在终端或命令提示符中运行以下命令以克隆 Tavily-MCP 仓库:

git clone https://github.com/tavily-ai/tavily-mcp.git
cd tavily-mcp

步骤 2: 安装依赖

进入仓库目录后,安装所有依赖项:

npm install

步骤 3: 构建项目

构建项目以生成可执行文件:

npm run build

🛠️ 配置指南

在 Claude 桌面应用中配置

  1. 打开配置文件:

    • macOS
      code ~/Library/Application\ Support/Claude/claude_desktop_config.json
      
    • Windows
      code %APPDATA%\Claude\claude_desktop_config.json
      
  2. 添加 Tavily-MCP 服务器配置:

    {
      "mcpServers": {
        "tavily-mcp": {
          "command": "npx",
          "args": ["-y", "tavily-mcp@1.0.0"],
          "env": {
            "TAVILY_API_KEY": "your-api-key-here"
          }
        }
      }
    }
    
    • your-api-key-here 替换为您的实际 Tavily API 密钥。

💻 使用指南

在 Claude 桌面应用中的使用

  1. 安装完成后,完全关闭并重新打开 Claude 桌面应用以使配置生效。
  2. 应用底部左侧会出现一个锤子图标,表示有可用的 MCP 工具。点击该图标可查看更多详细信息。

💡 功能示例

Tavily Search 示例

通用网络搜索

你能查找量子计算领域的最新发展吗?

新闻搜索

查找过去一周关于 AI 初创公司的新闻文章。

特定领域搜索

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

Tavily Extract 示例

提取文章内容

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

组合使用 Search 和 Extract

您可以结合 Tavily-Search 和 Tavily-Extract 工具来执行更复杂的任务。

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

🛠️ 故障排除

常见问题

服务器未找到

  • 验证 npm 安装状态,运行 npm --version
  • 检查 Claude 桌面应用配置文件语法,运行 code ~/Library/Application\ Support/Claude/claude_desktop_config.json
  • 确保 Node.js 正确安装,运行 node --version

NPX 相关问题

  • 如果遇到与 npx 相关的错误,请使用 npx 的完整路径替换配置中的 "command": "npx"
    which npx
    
    然后在配置中替换为:
    "command": "/full/path/to/npx"
    

API 密钥问题

  • 确认您的 Tavily API 密钥有效。
  • 检查密钥是否正确设置在配置文件中。
  • 确保密钥没有空格或引号。

🙏 致谢

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端