Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client