Tavily MCP Server 使用说明

项目简介

Tavily MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，它利用 Tavily API 为大型语言模型 (LLM) 应用提供强大的 AI 驱动的网页搜索功能。此服务器允许 LLM 客户端通过 MCP 协议调用搜索工具和访问搜索结果资源，从而获取最新的网络信息作为上下文，增强 LLM 的应用能力。

主要功能点

AI 驱动的网页搜索: 利用 Tavily API 执行智能网页搜索，返回高质量的搜索结果。
基本和高级搜索深度: 支持快速的基本搜索和更全面的高级搜索，以满足不同场景的需求。
结构化搜索结果: 返回包含标题、URL 和内容片段的详细搜索结果，并提供 AI 生成的摘要。
搜索结果缓存和持久化: 所有搜索历史和结果都会被缓存并持久化存储，提高响应速度并减少 API 调用。
MCP 资源访问:
- 静态资源 'tavily://last-search/result': 访问最近一次搜索的结果。
- 动态资源模板 'tavily://search/{query}': 根据查询词动态获取搜索结果。
MCP 工具调用: 提供 'search' 工具，允许客户端发起新的搜索请求。

安装步骤

克隆仓库:

git clone https://github.com/it-beard/tavily-server.git
cd tavily-server

安装依赖:
```
npm install
```
构建项目:
```
npm run build
```

服务器配置

此 Tavily MCP Server 可与任何 MCP 客户端配合使用。以下是针对常见 MCP 客户端的配置示例。您需要在 MCP 客户端的配置文件中添加如下服务器配置信息。

针对 Cline 或 Claude Desktop 的配置 (JSON 格式示例):

{
  "mcpServers": {
    "tavily": {
      "command": "node",
      "args": ["/path/to/tavily-server/build/index.js"], //  请替换为您的 'tavily-server' 仓库中 'build/index.js' 文件的**绝对路径**
      "env": {
        "TAVILY_API_KEY": "YOUR_TAVILY_API_KEY"  // 请替换为您在 Tavily 官网申请的 API 密钥
      }
    }
  }
}

配置参数说明:

'server name': 'tavily' (服务器名称，可自定义)
'command': 'node' (运行服务器的命令，这里使用 Node.js)
'args': '["/path/to/tavily-server/build/index.js"]' (命令参数，指向编译后的服务器主程序文件。请务必将 '/path/to/tavily-server' 替换为您本地仓库的绝对路径)
'env': '{"TAVILY_API_KEY": "YOUR_TAVILY_API_KEY"}' (环境变量配置，'TAVILY_API_KEY' 用于 Tavily API 认证。请务必将 'YOUR_TAVILY_API_KEY' 替换为您真实的 Tavily API 密钥)

注意: MCP 客户端需要配置正确的 'command' 和 'args' 才能启动 Tavily MCP 服务器并建立连接。请根据您的实际安装路径和 API 密钥修改配置信息。

基本使用方法

启动服务器: 在配置好 MCP 客户端后，启动 Tavily MCP Server。通常情况下，MCP 客户端会自动启动配置的 MCP 服务器。您也可以在 'tavily-server' 仓库目录下执行 'npm run start' 命令手动启动服务器。

使用 'search' 工具: 在您的 LLM 客户端中，可以使用 'search' 工具进行网页搜索。工具名称为 'tavily'，工具方法为 'search'。

请求示例 (概念性示例，实际请求方式取决于您的 MCP 客户端):

// 调用 'search' 工具，查询 "人工智能最新进展"
const result = await mcpClient.callTool("tavily", "search", {
  query: "人工智能最新进展",
  search_depth: "advanced" // 可选参数，指定搜索深度，可选 "basic" 或 "advanced"
});
console.log(result); // 打印搜索结果

访问资源: 您可以通过 MCP 资源 URI 访问搜索结果。
- 'tavily://last-search/result': 获取最近一次搜索的结果。
- 'tavily://search/{query}': 获取指定查询词的搜索结果。例如，'tavily://search/自然语言处理' (请确保 URL 编码查询词)。

通过工具和资源，您的 LLM 应用可以方便地利用 Tavily MCP Server 提供的网页搜索能力，获取实时信息，提升应用效果。

关键词