mcp-omnisearch
mcp-omnisearch
Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso unificado a múltiples proveedores de búsqueda y herramientas de IA. Este servidor combina las capacidades de Tavily, Perplexity, Kagi, Jina AI, Brave y Firecrawl para ofrecer funciones integrales de búsqueda, respuestas de IA, procesamiento de contenido y mejora a través de una única interfaz.
Características
🔍 Herramientas de búsqueda
Búsqueda Tavily : Optimizada para obtener información objetiva con un sólido sistema de citas. Admite el filtrado de dominios mediante parámetros de la API (include_domains/exclude_domains).
Brave Search : Búsqueda centrada en la privacidad con una buena cobertura de contenido técnico. Ofrece compatibilidad nativa con operadores de búsqueda (site:, -site:, filetype:, intitle:, inurl:, before:, after: y frases exactas).
Kagi Search : Resultados de búsqueda de alta calidad con mínima influencia publicitaria, enfocados en fuentes confiables. Admite operadores de búsqueda en cadenas de consulta (site:, -site:, filetype:, intitle:, inurl:, before:, after: y frases exactas).
🎯 Operadores de búsqueda
MCP Omnisearch proporciona potentes capacidades de búsqueda a través de operadores y parámetros:
Funciones de búsqueda comunes
Filtrado de dominios: disponible en todos los proveedores
Tavily: A través de parámetros API (include_domains/exclude_domains)
Brave & Kagi: A través de los operadores site: y -site:
Filtrado de tipo de archivo: disponible en Brave y Kagi (tipo de archivo:)
Filtrado de títulos y URL: disponible en Brave y Kagi (intitle:, inurl:)
Filtrado de fechas: Disponible en Brave y Kagi (antes:, después:)
Coincidencia de frases exactas: Disponible en Brave y Kagi ("frase")
Ejemplo de uso
// Using Brave or Kagi with query string operators
{
"query": "filetype:pdf site:microsoft.com typescript guide"
}
// Using Tavily with API parameters
{
"query": "typescript guide",
"include_domains": ["microsoft.com"],
"exclude_domains": ["github.com"]
}Capacidades del proveedor
Brave Search : Compatibilidad total con operadores nativos en la cadena de consulta
Kagi Search : Soporte completo de operadores en la cadena de consulta
Tavily Search : Filtrado de dominios mediante parámetros API
🤖 Herramientas de respuesta de IA
Perplexity AI : Generación de respuestas avanzadas que combina la búsqueda web en tiempo real con GPT-4 Omni y Claude 3
Kagi FastGPT : Respuestas rápidas generadas por IA con citas (tiempo de respuesta típico: 900 ms)
📄 Herramientas de procesamiento de contenido
Jina AI Reader : Extracción de contenido limpio con subtítulos de imágenes y compatibilidad con PDF
Kagi Universal Summarizer : resumen de contenido para páginas, vídeos y podcasts
Tavily Extract : Extrae contenido sin procesar de una o varias páginas web con un nivel de extracción configurable (básico o avanzado). Devuelve contenido combinado y contenido de URL individuales, con metadatos que incluyen recuento de palabras y estadísticas de extracción.
Firecrawl Scrape : extrae datos limpios y listos para LLM de URL individuales con opciones de formato mejoradas
Firecrawl Crawl : rastreo profundo de todas las subpáginas accesibles en un sitio web con límites de profundidad configurables
Mapa de Firecrawl : recopilación rápida de URL de sitios web para un mapeo completo del sitio
Firecrawl Extract : Extracción de datos estructurados con IA mediante indicaciones en lenguaje natural
Acciones de Firecrawl : Compatibilidad con interacciones de página (clics, desplazamientos, etc.) antes de la extracción de contenido dinámico
🔄 Herramientas de mejora
API de enriquecimiento de Kagi : contenido complementario de índices especializados (Teclis, TinyGem)
Jina AI Grounding : Verificación de hechos en tiempo real con base en el conocimiento web
Related MCP server: MCP Search Server
Requisitos de clave API flexibles
MCP Omnisearch está diseñado para funcionar con las claves API disponibles. No es necesario tener claves para todos los proveedores: el servidor detectará automáticamente las claves API disponibles y solo las habilitará.
Por ejemplo:
Si solo tiene una clave API de Tavily y Perplexity, solo esos proveedores estarán disponibles
Si no tiene una clave API de Kagi, los servicios basados en Kagi no estarán disponibles, pero todos los demás proveedores funcionarán normalmente.
El servidor registrará qué proveedores están disponibles según las claves API que haya configurado
Esta flexibilidad permite comenzar fácilmente con uno o dos proveedores y agregar más según sea necesario.
Configuración
Este servidor requiere configuración a través de su cliente MCP. A continuación, se muestran ejemplos para diferentes entornos:
Configuración de Cline
Agregue esto a su configuración de Cline MCP:
{
"mcpServers": {
"mcp-omnisearch": {
"command": "node",
"args": ["/path/to/mcp-omnisearch/dist/index.js"],
"env": {
"TAVILY_API_KEY": "your-tavily-key",
"PERPLEXITY_API_KEY": "your-perplexity-key",
"KAGI_API_KEY": "your-kagi-key",
"JINA_AI_API_KEY": "your-jina-key",
"BRAVE_API_KEY": "your-brave-key",
"FIRECRAWL_API_KEY": "your-firecrawl-key"
},
"disabled": false,
"autoApprove": []
}
}
}Escritorio Claude con configuración WSL
Para entornos WSL, agregue esto a su configuración de Claude Desktop:
{
"mcpServers": {
"mcp-omnisearch": {
"command": "wsl.exe",
"args": [
"bash",
"-c",
"TAVILY_API_KEY=key1 PERPLEXITY_API_KEY=key2 KAGI_API_KEY=key3 JINA_AI_API_KEY=key4 BRAVE_API_KEY=key5 FIRECRAWL_API_KEY=key6 node /path/to/mcp-omnisearch/dist/index.js"
]
}
}
}Variables de entorno
El servidor utiliza claves API para cada proveedor. No necesita claves para todos los proveedores ; solo se activarán los que correspondan a sus claves API disponibles.
TAVILY_API_KEY: Para la búsqueda de TavilyPERPLEXITY_API_KEY: Para Perplexity AIKAGI_API_KEY: Para servicios Kagi (FastGPT, Summarizer, Enriquecimiento)JINA_AI_API_KEY: Para servicios de inteligencia artificial de Jina (Lector, Conexión a tierra)BRAVE_API_KEY: Para Brave SearchFIRECRAWL_API_KEY: Para servicios de Firecrawl (Rastreo, Mapeo, Extracción, Acciones)
Puedes empezar con una o dos claves API y añadir más según sea necesario. El servidor registrará los proveedores disponibles al iniciar.
API
El servidor implementa herramientas MCP organizadas por categoría:
Herramientas de búsqueda
búsqueda_tavily
Busca en la web con la API de búsqueda de Tavily. Ideal para consultas basadas en hechos que requieren fuentes y citas fiables.
Parámetros:
query(cadena, obligatoria): consulta de búsqueda
Ejemplo:
{
"query": "latest developments in quantum computing"
}búsqueda_valiente
Búsqueda web centrada en la privacidad con buena cobertura de temas técnicos.
Parámetros:
query(cadena, obligatoria): Consulta de búsqueda
Ejemplo:
{
"query": "rust programming language features"
}búsqueda_kagi
Resultados de búsqueda de alta calidad con mínima influencia publicitaria. Ideal para encontrar fuentes confiables y materiales de investigación.
Parámetros:
query(cadena, obligatoria): Consulta de búsquedalanguage(cadena, opcional): filtro de idioma (p. ej., "en")no_cache(booleano, opcional): omite la caché para resultados nuevos
Ejemplo:
{
"query": "latest research in machine learning",
"language": "en"
}Herramientas de respuesta de IA
ai_perplejidad
Generación de respuestas impulsada por IA con integración de búsqueda web en tiempo real.
Parámetros:
query(cadena, obligatoria): Pregunta o tema para la respuesta de IA
Ejemplo:
{
"query": "Explain the differences between REST and GraphQL"
}ai_kagi_fastgpt
Respuestas rápidas generadas por IA con citas.
Parámetros:
query(cadena, obligatoria): Pregunta para una respuesta rápida de IA
Ejemplo:
{
"query": "What are the main features of TypeScript?"
}Herramientas de procesamiento de contenido
lector de procesos de Jina
Convierta URL en texto limpio y compatible con LLM con subtítulos de imagen.
Parámetros:
url(cadena, obligatoria): URL a procesar
Ejemplo:
{
"url": "https://example.com/article"
}resumen_de_proceso_kagi
Resumir el contenido de las URL.
Parámetros:
url(cadena, obligatoria): URL para resumir
Ejemplo:
{
"url": "https://example.com/long-article"
}proceso_tavily_extracto
Extraiga contenido sin procesar de páginas web con Tavily Extract.
Parámetros:
url(cadena | cadena[], obligatorio): URL única o matriz de URL para extraer contenidoextract_depth(cadena, opcional): Profundidad de extracción: 'básica' (predeterminada) o 'avanzada'
Ejemplo:
{
"url": [
"https://example.com/article1",
"https://example.com/article2"
],
"extract_depth": "advanced"
}La respuesta incluye:
Contenido combinado de todas las URL
Contenido sin procesar individual para cada URL
Metadatos con recuento de palabras, extracciones exitosas y URL fallidas
proceso de raspado de firecrawl
Extraiga datos limpios y listos para LLM de URL individuales con opciones de formato mejoradas.
Parámetros:
url(cadena | cadena[], obligatorio): URL única o matriz de URL para extraer contenidoextract_depth(cadena, opcional): Profundidad de extracción: 'básica' (predeterminada) o 'avanzada'
Ejemplo:
{
"url": "https://example.com/article",
"extract_depth": "basic"
}La respuesta incluye:
Contenido limpio y con formato Markdown
Metadatos que incluyen título, recuento de palabras y estadísticas de extracción
proceso de rastreo de fuego
Rastreo profundo de todas las subpáginas accesibles en un sitio web con límites de profundidad configurables.
Parámetros:
url(cadena | cadena[], obligatorio): URL de inicio para el rastreoextract_depth(cadena, opcional): Profundidad de extracción: 'básica' (predeterminada) o 'avanzada' (controla la profundidad y los límites del rastreo)
Ejemplo:
{
"url": "https://example.com",
"extract_depth": "advanced"
}La respuesta incluye:
Contenido combinado de todas las páginas rastreadas
Contenido individual para cada página
Metadatos que incluyen título, recuento de palabras y estadísticas de rastreo
proceso del mapa de rastreo de fuego
Recopilación rápida de URL de sitios web para un mapeo completo del sitio.
Parámetros:
url(cadena | cadena[], obligatorio): URL a mapearextract_depth(cadena, opcional): Profundidad de extracción: 'básica' (predeterminada) o 'avanzada' (controla la profundidad del mapa)
Ejemplo:
{
"url": "https://example.com",
"extract_depth": "basic"
}La respuesta incluye:
Lista de todas las URL descubiertas
Metadatos que incluyen el título del sitio y el número de URL
proceso de extracción de firecrawl
Extracción de datos estructurados con IA utilizando indicaciones en lenguaje natural.
Parámetros:
url(cadena | cadena[], obligatorio): URL de la que extraer datos estructuradosextract_depth(cadena, opcional): Profundidad de extracción: 'básica' (predeterminada) o 'avanzada'
Ejemplo:
{
"url": "https://example.com",
"extract_depth": "basic"
}La respuesta incluye:
Datos estructurados extraídos de la página
Metadatos que incluyen título y estadísticas de extracción
proceso de acciones de firecrawl
Soporte para interacciones de página (clics, desplazamiento, etc.) antes de la extracción de contenido dinámico.
Parámetros:
url(cadena | cadena[], obligatorio): URL para interactuar y extraer contenido de ellaextract_depth(cadena, opcional): Profundidad de extracción: 'básica' (predeterminada) o 'avanzada' (controla la complejidad de las interacciones)
Ejemplo:
{
"url": "https://news.ycombinator.com",
"extract_depth": "basic"
}La respuesta incluye:
Contenido extraído después de realizar interacciones
Descripción de las acciones realizadas
Captura de pantalla de la página (si está disponible)
Metadatos que incluyen título y estadísticas de extracción
Herramientas de mejora
mejorar_el_enriquecimiento_kagi
Obtenga contenido complementario de índices especializados.
Parámetros:
query(cadena, obligatoria): Consulta para enriquecimiento
Ejemplo:
{
"query": "emerging web technologies"
}mejorar_jina_grounding
Verificar las afirmaciones frente al conocimiento web.
Parámetros:
statement(cadena, obligatoria): Declaración a verificar
Ejemplo:
{
"statement": "TypeScript adds static typing to JavaScript"
}Desarrollo
Configuración
Clonar el repositorio
Instalar dependencias:
pnpm installConstruir el proyecto:
pnpm run buildEjecutar en modo de desarrollo:
pnpm run devPublicación
Actualizar la versión en package.json
Construir el proyecto:
pnpm run buildPublicar en npm:
pnpm publishSolución de problemas
Claves API y acceso
Cada proveedor requiere su propia clave API y puede tener diferentes requisitos de acceso:
Tavily : Requiere una clave API de su portal para desarrolladores
Perplejidad : acceso a la API a través de su programa de desarrollador
Kagi : Algunas funciones están limitadas a los usuarios del plan Business (Team)
Jina AI : Se requiere una clave API para todos los servicios
Brave : clave API de su portal para desarrolladores
Firecrawl : Se requiere una clave API desde su portal para desarrolladores
Límites de velocidad
Cada proveedor tiene sus propios límites de velocidad. El servidor gestionará los errores de límite de velocidad correctamente y devolverá los mensajes de error correspondientes.
Contribuyendo
¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.
Licencia
Licencia MIT: consulte el archivo LICENCIA para obtener más detalles.
Expresiones de gratitud
Construido sobre:
Available Tools
2 toolsexecuteRun JavaScript in an isolated Pi QuickJS sandbox. Discover native provider functions with search, then call await tools.<name>(args). Use return, text() or console.log() for output. Promise.all supports parallel requests. Only final output reaches the client. No filesystem, network, Node APIs, modules or timers. Credentials stay on the host. At most 20 provider calls; 64 MiB heap; default deadline 60 seconds. Results are raw provider JSON. Async jobs return IDs: retrieve their status in a later call. No automatic retries. Calls already made are not undone on failure. State is not persisted between executions.ADestructive
Run JavaScript in an isolated Pi QuickJS sandbox. Discover native provider functions with search, then call await tools.(args). Use return, text() or console.log() for output. Promise.all supports parallel requests. Only final output reaches the client. No filesystem, network, Node APIs, modules or timers. Credentials stay on the host. At most 20 provider calls; 64 MiB heap; default deadline 60 seconds. Results are raw provider JSON. Async jobs return IDs: retrieve their status in a later call. No automatic retries. Calls already made are not undone on failure. State is not persisted between executions.
Inputs: code (required), timeout_ms, large_result_mode.
searchDiscover configured provider API functions for Code Mode. Omit query to list names and descriptions. Supply a function name or space-separated keywords to get matching TypeScript declarations. Call this before execute; arguments and results use native provider formats, not the consolidated tool formats.ARead-onlyIdempotent
Discover configured provider API functions for Code Mode. Omit query to list names and descriptions. Supply a function name or space-separated keywords to get matching TypeScript declarations. Call this before execute; arguments and results use native provider formats, not the consolidated tool formats.
Inputs: query.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
Search is for discovering provider function signatures, while execute runs JavaScript in the sandbox; the descriptions clearly separate these phases and explicitly link them. However, the bare name 'search' could initially be mistaken for a provider-level search action rather than meta-discovery, and there is no distinct 'list' tool since search doubles as listing when the query is omitted.
Both tools use a consistent single-verb convention with no mixing of camelCase or snake_case. The names are generic and lack an object (e.g., search_tools or execute_code), but the style is predictable across the set.
Two tools exactly match the two-phase Code Mode workflow: discover available provider functions, then execute a program that calls them. It is on the thin side of the typical 3-15 range, but each tool clearly earns its place and there is no redundancy.
The core lifecycle is covered: search handles both listing and keyword lookup, and execute supports provider invocation, parallelism, and output. Minor gaps exist around explicit job-status polling, cancellation, and provider configuration management, though these may be reachable through execute calls.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Jina AI Reader/Search MCP — turn any URL into clean LLM-ready markdown, plus web search.
Multi-engine search for AI agents. Trust scoring, local corpus, MCP-native. Self-hostable, BYOK.
Unified 15-tool SEO, SERP, clean Markdown & GEO (LLM citation Share-of-Voice) MCP server.
Related MCP Servers
- AlicenseAqualityDmaintenanceA Model Context Protocol server that enables web search, scraping, crawling, and content extraction through multiple engines including SearXNG, Firecrawl, and Tavily.4230 npm148MIT
- -licenseNot gradedqualityNot gradedmaintenanceA unified Model Context Protocol server that integrates multiple search providers including Brave, Tavily, Exa, Semantic Scholar, and arXiv. It enables users to perform web, news, and image searches alongside academic research and citation analysis through a single interface.-
- AlicenseAqualityBmaintenanceA Model Context Protocol server that gives AI assistants access to 7 search providers with intelligent auto-routing. Analyzes query intent and picks the best provider automatically — no manual switching needed. Install, configure your keys, and go.2172 PyPI5MIT
- AlicenseNot gradedqualityDmaintenanceA unified MCP server aggregating 15 web search and extraction tools across 5 providers (Jina, Tavily, Exa, Firecrawl, Bocha) with automatic API key validation and plugin architecture.MIT