使用说明

项目简介

Tavily MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 客户端提供 Tavily Search 和 Tavily Extract 工具。它允许 LLM 通过标准化的 MCP 协议安全地访问实时的网络搜索和网页内容提取功能，从而增强 LLM 的上下文理解和信息获取能力。

主要功能点

网页搜索 (tavily-search): 提供强大的网页搜索功能，可以根据关键词进行通用搜索、新闻搜索以及特定领域的搜索。支持设置搜索深度、时间范围、结果数量和域名过滤等高级参数，帮助 LLM 获取最新、最相关的网络信息。
内容提取 (tavily-extract): 允许从指定的 URL 列表中提取网页的结构化内容。可以根据需求选择基础或高级提取深度，并可选择包含图片信息，为 LLM 提供网页内容的精细化分析能力。
MCP 协议兼容: 完全遵循 Model Context Protocol 标准，能够与任何兼容 MCP 协议的客户端（如 Cursor 和 Claude Desktop）无缝集成，为 LLM 应用提供即插即用的上下文服务。

安装步骤

安装 Node.js: 确保你的系统已安装 Node.js (v20 或更高版本)。你可以通过运行 'node --version' 命令来检查 Node.js 版本。
获取 Tavily API 密钥: 访问 Tavily 官网注册并获取你的 Tavily API 密钥。免费账户即可使用。
运行 Tavily MCP Server: 打开终端，运行以下 NPX 命令即可启动 Tavily MCP Server：
```
npx -y [email protected]
```

服务器配置

Tavily MCP Server 作为一个 MCP 服务器，需要配置到 MCP 客户端中才能使用。以下是在 Claude Desktop 客户端中配置 Tavily MCP Server 的 JSON 格式配置信息：

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": {
        "TAVILY_API_KEY": "YOUR_TAVILY_API_KEY"  // 请替换为你的 Tavily API 密钥
      }
    }
  }
}

配置说明:

'"server name"': 'tavily-mcp'，服务器名称，可以自定义。
'"command"': 'npx'，运行服务器的命令，这里使用 NPX 运行。
'"args"': '["-y", "[email protected]"]'，传递给 'npx' 的参数，指定运行 'tavily-mcp' 包的 0.1.3 版本。
'"env"': 环境变量配置。
- '"TAVILY_API_KEY"': '"YOUR_TAVILY_API_KEY"'，请务必替换为你在 Tavily 官网申请的 API 密钥。

将以上 JSON 配置信息添加到你的 MCP 客户端配置文件中（例如 Claude Desktop 的 'claude_desktop_config.json' 文件），并重启客户端，即可连接到 Tavily MCP Server。

基本使用方法

成功配置并连接 Tavily MCP Server 后，在 MCP 客户端中，你可以通过自然语言指令来调用 'tavily-search' 和 'tavily-extract' 工具。例如，在 Claude Desktop 中，你可以这样提问：

使用 tavily-search 搜索关于量子计算的最新进展
使用 tavily-extract 提取以下链接的内容：https://example.com/article

客户端会自动识别并调用相应的工具，利用 Tavily MCP Server 提供的功能来增强 LLM 的能力。你可以参考仓库 README.md 文件中提供的更多使用示例。

关键词