Github 9a2

🚀 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 密钥有效。
• 检查密钥是否正确设置在配置文件中。
• 确保密钥没有空格或引号。

🙏 致谢

• Model Context Protocol 提供 MCP 规范
• Anthropic 提供 Claude 桌面应用