mcp-omnisearch

mcp-omnisearch

一个 Model Context Protocol（MCP）服务，通过四个整合工具，统一接入 Tavily、Brave、Kagi、Exa AI、GitHub、Linkup 和 Firecrawl。

快速开始

使用 MCPick安装已发布的服务：

npx mcpick add \
  --name mcp-omnisearch \
  --command npx \
  --args=-y,mcp-omnisearch

MCPick 默认使用 Claude Code。使用 --client 和 --scope 指定其他客户端，或将服务添加到当前仓库：

npx mcpick add \
  --name mcp-omnisearch \
  --command npx \
  --args=-y,mcp-omnisearch \
  --client vscode \
  --scope project

有关支持的客户端和提供商凭据存储选项，请参阅部署。

也可以从源代码运行：

pnpm install
pnpm run build
node ./dist/index.js

没有密钥的提供商会被跳过，其余提供商仍可正常工作。如果你的客户端支持环境变量展开，请引用密钥，而不是将密钥值存储在 MCP 配置中：

{
	"mcpServers": {
		"mcp-omnisearch": {
			"command": "npx",
			"args": ["-y", "mcp-omnisearch"],
			"env": {
				"TAVILY_API_KEY": "${TAVILY_API_KEY}",
				"EXA_API_KEY": "${EXA_API_KEY}"
			}
		}
	}
}

只添加你要使用的提供商密钥。展开语法和密钥存储方式因客户端而异；有关安全选项和明文回退指南，请参阅 部署。

工具

web_search

使用 Tavily、Brave、Kagi 或 Exa 搜索网页。

{
	"query": "latest SvelteKit releases",
	"provider": "tavily",
	"limit": 10,
	"search_depth": "advanced",
	"topic": "news",
	"time_range": "month",
	"safe_search": true,
	"include_raw_content": false,
	"auto_parameters": false
}

搜索控制选项仅在所选提供商支持时生效。

ai_search

使用 Exa Answer、Linkup 或 Tavily Research 获取带来源的 AI 答案。 Tavily Research 会先返回任务 ID；将其作为 research_id 传回即可获取报告。

{
	"query": "Explain the differences between REST and GraphQL",
	"provider": "exa_answer"
}

github_search

搜索 GitHub 代码、仓库或用户。

{
	"query": "filename:remote.ts @sveltejs/kit",
	"search_type": "code",
	"limit": 5
}

web_extract

使用 Tavily、Firecrawl 或 Exa 提取、爬取、抓取内容或查找相似内容。

{
	"url": "https://example.com/long-article",
	"provider": "tavily",
	"mode": "extract",
	"extract_depth": "advanced",
	"query": "installation requirements",
	"chunks_per_source": 3,
	"format": "markdown"
}

文档

• 提供商选择 — 根据任务、密钥、模式和功能选择提供商。
• 搜索运算符 — 运算符支持矩阵和经过测试的示例。
• 大型结果 — 内联与文件响应行为，以及远程部署注意事项。
• 部署 — MCP 客户端、WSL 和 Firecrawl 设置。
• 故障排除 — 密钥、访问、验证、速率限制和常见故障。

环境变量

• TAVILY_API_KEY
• KAGI_API_KEY
• BRAVE_API_KEY
• GITHUB_API_KEY
• EXA_API_KEY
• LINKUP_API_KEY
• FIRECRAWL_API_KEY
• FIRECRAWL_BASE_URL 可选，用于可自托管的 Firecrawl
• OMNISEARCH_LARGE_RESULT_MODE 可选，默认值为 file，也可设为 inline

开发

pnpm install
pnpm run build
pnpm test

提交 PR 前，请阅读 CONTRIBUTING.md。

许可证

MIT 许可证 — 详见 LICENSE。

致谢

基于 Model Context Protocol、 Tavily、Kagi、 Brave Search、Exa AI、 Linkup 和 Firecrawl 构建。