Tavily MCP Server 使用说明

项目简介

Tavily MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它利用 Tavily 搜索引擎的 API 为大型语言模型 (LLM) 应用提供强大的网页搜索功能。通过此服务器，LLM 可以执行复杂的网络搜索，获取直接答案，并检索最新的新闻资讯，所有结果均由 AI 提取相关内容，以便 LLM 更好地理解和利用网络信息。

主要功能点

AI 驱动的网页搜索: 利用 Tavily 搜索引擎的先进 AI 技术，提供高质量的网页搜索结果。
多种搜索工具:
- 'tavily_web_search': 执行全面的网页搜索，提取网页中的相关内容，适用于研究、信息收集等多种场景。
- 'tavily_answer_search': 在网页搜索的基础上，AI 自动生成针对用户查询的直接答案，并提供来源依据，快速获取精准答案。
- 'tavily_news_search': 专门搜索近期新闻文章，帮助 LLM 掌握最新的时事动态。
可配置的搜索参数: 支持设置最大返回结果数、搜索深度（基础/高级）、搜索时间范围（新闻搜索）以及域名白名单/黑名单，精细控制搜索范围和结果。
Prompt 模板: 预置了针对不同搜索工具的 Prompt 模板，方便用户快速发起搜索请求。
易于集成: 作为 MCP 服务器，可以方便地与支持 MCP 协议的 LLM 客户端集成，例如 Claude。

安装步骤

安装 Python 包: 使用 pip 或 uv 安装 'mcp-tavily' 包。

pip install mcp-tavily

或

uv pip install mcp-tavily

或者，从源码构建: 如果需要从源码构建，请先克隆仓库：

git clone https://github.com/RamXX/mcp-tavily.git
cd mcp-tavily
uv build  # 或 python -m build
uv pip install . # 或 pip install .

服务器配置

MCP 服务器需要配置 Tavily API 密钥才能正常工作。您可以从 Tavily 官网获取 API 密钥。

在 MCP 客户端（例如 Claude）中，您需要配置 MCP 服务器的启动命令和参数。以下是 Claude.app 的配置示例：

{
  "mcpServers": {
    "tavily": {  // 服务器名称，可以自定义
      "command": "python", // 启动命令，通常为 python
      "args": ["-m", "mcp_server_tavily"] // 启动参数，指定运行 mcp_server_tavily 模块
    },
    "env": {
      "TAVILY_API_KEY": "YOUR_TAVILY_API_KEY" //  Tavily API 密钥，请替换为您的密钥
    }
  }
}

配置说明:

'"tavily"': 服务器名称，您可以自定义，用于在客户端中标识和调用该服务器。
'"command": "python"': 指定运行服务器的命令为 'python'。请确保您的 Python 环境已正确配置。如果遇到问题，可以尝试使用 Python 解释器的完整路径（可以使用 'which python' 命令查找）。
'"args": ["-m", "mcp_server_tavily"]': 指定 Python 运行的模块为 'mcp_server_tavily'，即启动 Tavily MCP Server。
'"env": { "TAVILY_API_KEY": "YOUR_TAVILY_API_KEY" }': 通过环境变量 'TAVILY_API_KEY' 传递您的 Tavily API 密钥。请务必将 '"YOUR_TAVILY_API_KEY"' 替换为您实际的 API 密钥。

API 密钥配置方式:

除了在 Claude 配置文件中设置环境变量外，您还可以：

设置系统环境变量: 在您的操作系统中设置 'TAVILY_API_KEY' 环境变量。

命令行参数: 在启动服务器时，通过命令行参数 '--api-key' 传递 API 密钥，例如：

python -m mcp_server_tavily --api-key=YOUR_TAVILY_API_KEY

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端中，您可以使用预定义的 Prompt 模板或直接调用 Tools 来使用 Tavily MCP Server 的搜索功能。

示例 Prompt:

网页搜索: 'Search the web using Tavily's AI-powered search engine' (参数: 'query')
答案搜索: 'Search the web and get an AI-generated answer with supporting evidence' (参数: 'query')
新闻搜索: 'Search recent news articles with Tavily's news search' (参数: 'query', 'days' (可选))

使用示例:

在 Claude 中，您可以直接输入自然语言指令，Claude 将根据您的指令智能地调用 Tavily MCP Server 的功能。例如：

'Tell me about Anthropic's newly released MCP protocol' (使用 'tavily_web_search' 工具)
'I want a concrete answer backed by current web sources: What is the average lifespan of redwood trees?' (使用 'tavily_answer_search' 工具)
'Give me the top 10 AI-related news in the last 5 days' (使用 'tavily_news_search' 工具)

您还可以通过 Prompt 参数来控制搜索行为，例如指定包含或排除的域名，搜索时间范围等。

调试:

可以使用 MCP Inspector 工具来调试服务器，具体方法请参考仓库 README 文档。

贡献

欢迎贡献代码，共同改进 Tavily MCP Server！

关键词