Tavily 搜索 MCP 服务器

Name: tavily-search-mcp-server
Author: apappascs

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

特征

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

Related MCP server: MCP2Tavily

工具

tavily_search
- 使用 Tavily Search API 执行网络搜索。
- 输入：
  - query （字符串，必需）：搜索查询。
  - search_depth （字符串，可选）：“basic”或“advanced”（默认值：“basic”）。
  - topic （字符串，可选）：“一般”或“新闻”（默认：“一般”）。
  - 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 （string[]，可选）：要包含的域。
  - exclude_domains （string[]，可选）：要排除的域。

设置指南🚀

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 配置文件：
# On Mac: ~/Library/Application\ Support/Claude/claude_desktop_config.json # On Windows: %APPDATA%\Claude\claude_desktop_config.json
根据您是否要使用npm或docker运行服务器，将以下内容之一添加到配置中的mcpServers对象：
选项 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自动安装 Tavily Search for Claude Desktop：

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 密钥提交到版本控制。出于安全原因，git 会忽略.env文件。

使用 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