MCP 服务器

tavily-search-mcp-server

一个集成了 Tavily 搜索 API 的 MCP 服务器实现，为 LLM 提供优化的搜索能力。

编程文档访问

数据库交互

Tools

tavily_search

Performs a web search using the Tavily Search API, optimized for LLMs. Use this for broad information gathering, recent events, or when you need diverse web sources. Supports search depth, topic selection, time range filtering, and domain inclusion/exclusion.

README

Tavily Search MCP 服务器

一个集成了 Tavily Search API 的 MCP 服务器实现，为 LLM 提供优化的搜索能力。

功能

网页搜索: 执行针对 LLM 优化的网页搜索，可以控制搜索深度、主题和时间范围。
内容提取: 从搜索结果中提取最相关的内容，优化质量和大小。
可选功能: 包括图像、图像描述、简短的 LLM 生成的答案和原始 HTML 内容。
域名过滤: 在搜索结果中包含或排除特定域名。

工具

tavily_search
- 使用 Tavily Search API 执行网页搜索。
- 输入:
  - query (字符串, 必需): 搜索查询。
  - search_depth (字符串, 可选): "basic" 或 "advanced" (默认: "basic")。
  - topic (字符串, 可选): "general" 或 "news" (默认: "general")。
  - days (数字, 可选): 新闻搜索的天数 (默认: 3)。
  - time_range (字符串, 可选): 时间范围过滤器 ("day", "week", "month", "year" 或 "d", "w", "m", "y")。
  - max_results (数字, 可选): 最大结果数 (默认: 5)。
  - include_images (布尔值, 可选): 包括相关图像 (默认: false)。
  - include_image_descriptions (布尔值, 可选): 包括图像描述 (默认: false)。
  - include_answer (布尔值, 可选): 包括简短的 LLM 生成的答案 (默认: false)。
  - include_raw_content (布尔值, 可选): 包括原始 HTML 内容 (默认: false)。
  - include_domains (字符串数组, 可选): 要包含的域名。
  - exclude_domains (字符串数组, 可选): 要排除的域名。

设置指南 🚀

1. 前提条件

您的计算机上安装了 Claude Desktop。
一个 Tavily API 密钥: a. 注册一个 Tavily API 帐户。 b. 选择一个计划 (提供免费层)。 c. 从 Tavily 仪表板生成您的 API 密钥。

2. 安装

将此存储库克隆到您计算机上的某个位置:

git clone https://github.com/apappascs/tavily-search-mcp-server.git

安装依赖项并构建项目:

cd tavily-search-mcp-server

npm install

npm run build

3. 与 Claude Desktop 集成

打开您的 Claude Desktop 配置文件:

# 在 Mac 上:
~/Library/Application\ Support/Claude/claude_desktop_config.json

# 在 Windows 上:
%APPDATA%\Claude\claude_desktop_config.json

将以下其中一个添加到配置中的 mcpServers 对象中，具体取决于您是想使用 npm 还是 docker 运行服务器:

选项 A: 使用 NPM (stdio 传输)

{
    "mcpServers": {
        "tavily-search-server": {
            "command": "node",
            "args": [
                "/Users/<username>/<FULL_PATH...>/tavily-search-mcp-server/dist/index.js"
            ],
            "env": {
                "TAVILY_API_KEY": "your_api_key_here"
            }
        }
    }
}

选项 B: 使用 NPM (SSE 传输)

{
    "mcpServers": {
        "tavily-search-server": {
            "command": "node",
            "args": [
                "/Users/<username>/<FULL_PATH...>/tavily-search-mcp-server/dist/sse.js"
            ],
            "env": {
                "TAVILY_API_KEY": "your_api_key_here"
            },
            "port": 3001
        }
    }
}

选项 C: 使用 Docker

{
    "mcpServers": {
        "tavily-search-server": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "TAVILY_API_KEY",
                "-v",
                "/Users/<username>/<FULL_PATH...>/tavily-search-mcp-server:/app",
                "tavily-search-mcp-server"
            ],
            "env": {
                "TAVILY_API_KEY": "your_api_key_here"
            }
        }
    }
}

重要步骤:
- 将 /Users/<username>/<FULL_PATH...>/tavily-search-mcp-server 替换为您克隆存储库的实际完整路径。
- 在 env 部分中添加您的 Tavily API 密钥。 最好始终将 API 密钥之类的机密作为环境变量。
- 即使在 Windows 上，也要确保在路径中使用正斜杠 (/)。
- 如果您正在使用 docker，请确保首先使用 docker build -t tavily-search-mcp-server:latest . 构建镜像。
重新启动 Claude Desktop 以使更改生效。

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Tavily Search:

npx -y @smithery/cli install @apappascs/tavily-search-mcp-server --client claude

环境变量设置 (对于 npm)

将 .env.example 复制到 .env:
```
cp .env.example .env
```
使用您的实际 Tavily API 密钥更新 .env 文件:
```
TAVILY_API_KEY=your_api_key_here
```
注意: 永远不要将您的实际 API 密钥提交到版本控制。出于安全原因，.env 文件会被 git 忽略。

使用 NPM 运行

使用 Node.js 启动服务器:

node dist/index.js

对于 sse 传输:

node dist/sse.js

使用 Docker 运行

构建 Docker 镜像 (如果尚未构建):

docker build -t tavily-search-mcp-server:latest .

运行 Docker 容器:

对于 stdio 传输:
```
docker run -it --rm -e TAVILY_API_KEY="your_api_key_here" tavily-search-mcp-server:latest
```
对于 sse 传输:
```
docker run -it --rm -p 3001:3001 -e TAVILY_API_KEY="your_api_key_here" -e TRANSPORT="sse" tavily-search-mcp-server:latest
```
您还可以直接利用 shell 的环境变量，这是一种更安全的做法:
```
 docker run -it --rm -p 3001:3001 -e TAVILY_API_KEY=$TAVILY_API_KEY -e TRANSPORT="sse" tavily-search-mcp-server:latest
```
注意: 第二个命令演示了使用 -e TAVILY_API_KEY=$TAVILY_API_KEY 将 TAVILY_API_KEY 环境变量的值传递到 Docker 容器中的推荐方法。这可以使您的 API 密钥远离您的命令历史记录，并且通常优于在命令中硬编码机密。
使用 docker compose

运行:
```
docker compose up -d
```
停止服务器:
```
docker compose down
```