MCP Omnisearch

mcp-omnisearch

Um servidor Model Context Protocol (MCP) que fornece acesso unificado a Tavily, Brave, Kagi, Exa AI, GitHub, Linkup e Firecrawl por meio de quatro ferramentas consolidadas.

Início rápido

Instale o servidor publicado com MCPick:

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

O MCPick usa Claude Code por padrão. Use --client e --scope para direcionar outro cliente ou adicionar o servidor ao repositório atual:

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

Consulte Implantação para ver os clientes suportados e as opções de armazenamento de credenciais do provedor.

Para executar a partir do código-fonte:

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

Provedores sem chaves são ignorados e os demais continuam funcionando. Se o seu cliente suportar expansão de variáveis de ambiente, referencie as chaves em vez de armazenar seus valores na configuração do MCP:

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

Adicione apenas as chaves dos provedores que você usa. A sintaxe de expansão e o armazenamento de segredos são específicos do cliente; consulte Implantação para opções seguras e orientações sobre fallback em texto simples.

Ferramentas

web_search

Pesquise na web com Tavily, Brave, Kagi, Exa ou Kagi Enrichment.

{
	"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
}

Os controles de pesquisa se aplicam quando suportados pelo provedor selecionado.

ai_search

Obtenha respostas de IA com fontes usando Kagi FastGPT, Exa Answer, Linkup ou Tavily Research. O Tavily Research retorna um ID de tarefa primeiro; passe-o de volta como research_id para recuperar o relatório.

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

github_search

Pesquise código, repositórios ou usuários no GitHub.

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

web_extract

Extraia, rastreie, raspe, resuma ou encontre conteúdo semelhante com Tavily, Kagi, Firecrawl ou Exa.

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

Documentação

• Seleção de provedor — escolha provedores por tarefa, chave, modo e capacidade.
• Operadores de pesquisa — matriz de suporte a operadores e exemplos testados.
• Resultados grandes — comportamento de resposta inline vs. arquivo e ressalvas de implantação remota.
• Implantação — configuração do cliente MCP, WSL e Firecrawl.
• Solução de problemas — chaves, acesso, validação, limites de taxa e falhas comuns.

Variáveis de ambiente

• TAVILY_API_KEY
• KAGI_API_KEY
• BRAVE_API_KEY
• GITHUB_API_KEY
• EXA_API_KEY
• LINKUP_API_KEY
• FIRECRAWL_API_KEY
• FIRECRAWL_BASE_URL opcional, para Firecrawl auto-hospedado
• OMNISEARCH_LARGE_RESULT_MODE opcional, padrão file ou inline

Desenvolvimento

pnpm install
pnpm run build
pnpm test

Leia CONTRIBUTING.md antes de abrir um PR.

Licença

Licença MIT — consulte LICENSE.

Agradecimentos

Construído sobre Model Context Protocol, Tavily, Kagi, Brave Search, Exa AI, Linkup e Firecrawl.