mcp-tavily-search

---

⚠️ 注意

此仓库已不再维护。

此工具的功能现在已包含在 mcp-omnisearch 中，它将多个 MCP 工具整合到一个统一的包中。

请使用 mcp-omnisearch 代替。

---

一个模型上下文协议 (MCP) 服务器，用于将 Tavily 的搜索 API 与 LLM 集成。此服务器提供智能网络搜索功能，针对高质量、基于事实的结果进行了优化，包括用于 RAG 应用的上下文生成和直接问答。

<a href="https://glama.ai/mcp/servers/1jcttrux58"><img width="380" height="200" src="https://glama.ai/mcp/servers/1jcttrux58/badge" alt="Tavily Search Server MCP server" /></a>

特性

• 🔍 通过 Tavily API 实现高级网络搜索功能
• 🤖 AI 生成的搜索结果摘要
• 🎯 领域过滤，以获得更高质量的结果
• 📊 可配置的搜索深度和参数
• 🧠 用于 RAG 应用的上下文生成
• ❓ 直接问答功能
• 💾 支持 TTL 的响应缓存
• 📝 多种响应格式（文本、JSON、markdown）
• 🔄 针对 LLM 优化的结构化结果格式
• 🏗️ 构建于模型上下文协议之上

配置

此服务器需要通过您的 MCP 客户端进行配置。以下是不同环境的示例：

Cline 配置

将其添加到您的 Cline MCP 设置中：

{
	"mcpServers": {
		"mcp-tavily-search": {
			"command": "npx",
			"args": ["-y", "mcp-tavily-search"],
			"env": {
				"TAVILY_API_KEY": "your-tavily-api-key"
			}
		}
	}
}

带有 WSL 的 Claude Desktop 配置

对于 WSL 环境，将其添加到您的 Claude Desktop 配置中：

{
	"mcpServers": {
		"mcp-tavily-search": {
			"command": "wsl.exe",
			"args": [
				"bash",
				"-c",
				"source ~/.nvm/nvm.sh && TAVILY_API_KEY=your-tavily-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-tavily-search"
			]
		}
	}
}

环境变量

服务器需要以下环境变量：

• TAVILY_API_KEY: 您的 Tavily API 密钥（必需）

API

该服务器实现了三个具有可配置参数的 MCP 工具：

tavily_search

使用 Tavily Search API 搜索网络，针对高质量、基于事实的结果进行了优化。

参数：

• query (string, required): 搜索查询
• search_depth (string, optional): "basic"（更快）或 "advanced"（更彻底）。默认为 "basic"
• topic (string, optional): "general" 或 "news"。默认为 "general"
• days (number, optional): 要搜索的天数（仅限新闻主题）。默认为 3
• time_range (string, optional): 结果的时间范围（'day'、'week'、'month'、'year' 或 'd'、'w'、'm'、'y'）
• max_results (number, optional): 最大结果数。默认为 5
• include_answer (boolean, optional): 包括 AI 生成的摘要。默认为 true
• include_images (boolean, optional): 包括相关图像。默认为 false
• include_image_descriptions (boolean, optional): 包括图像描述。默认为 false
• include_raw_content (boolean, optional): 包括原始 HTML 内容。默认为 false
• include_domains (string[], optional): 要包含的受信任域的列表
• exclude_domains (string[], optional): 要排除的域的列表
• response_format (string, optional): 'text'、'json' 或 'markdown'。默认为 'text'
• cache_ttl (number, optional): 缓存生存时间（以秒为单位）。默认为 3600
• force_refresh (boolean, optional): 强制刷新结果，忽略缓存。默认为 false

tavily_get_search_context

使用 Tavily 搜索为 RAG 应用生成上下文。

参数：

• query (string, required): 用于上下文生成的搜索查询
• max_tokens (number, optional): 生成的上下文的最大长度。默认为 2000
• search_depth (string, optional): "basic" 或 "advanced"。默认为 "advanced"
• topic (string, optional): "general" 或 "news"。默认为 "general"
• 其他参数与 tavily_search 相同

tavily_qna_search

使用 Tavily 搜索获取问题的直接答案。

参数：

• query (string, required): 要回答的问题
• include_sources (boolean, optional): 包括来源引用。默认为 true
• search_depth (string, optional): "basic" 或 "advanced"。默认为 "advanced"
• topic (string, optional): "general" 或 "news"。默认为 "general"
• 其他参数与 tavily_search 相同

域名过滤

服务器支持通过两个可选参数进行灵活的域名过滤：

• include_domains: 要包含在搜索结果中的受信任域的数组
• exclude_domains: 要从搜索结果中排除的域的数组

这允许您：

• 针对学术或技术搜索，定位特定的受信任来源
• 排除潜在的不可靠或不相关的来源
• 根据您的特定需求自定义来源
• 在未指定过滤时访问所有可用的来源

域名过滤示例：

{
	"include_domains": ["arxiv.org", "science.gov"],
	"exclude_domains": ["example.com"]
}

开发

设置

1. 克隆存储库
2. 安装依赖项：

pnpm install

3. 构建项目：

pnpm build

4. 在开发模式下运行：

pnpm dev

发布

该项目使用 changesets 进行版本管理。要发布：

1. 创建一个 changeset：

pnpm changeset

2. 对包进行版本控制：

pnpm changeset version

3. 发布到 npm：

pnpm release

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

MIT 许可证 - 有关详细信息，请参见 LICENSE 文件。

致谢

• 构建于 模型上下文协议 之上
• 由 Tavily Search API 提供支持