JinaAI Search

Búsqueda web eficiente optimizada para contenido compatible con LLM utilizando la API de Jina AI.

Documentación

mcp-jinaai-search

⚠️ Aviso

Este repositorio ya no se mantiene.

La funcionalidad de esta herramienta ahora está disponible en mcp-omnisearch, que combina múltiples herramientas MCP en un paquete unificado.

Por favor, usa mcp-omnisearch en su lugar.

Un servidor de Model Context Protocol (MCP) para integrar la API de búsqueda de Jina.ai con LLMs. Este servidor proporciona capacidades de búsqueda web eficientes y completas, optimizadas para recuperar contenido limpio y amigable para LLMs desde la web.

Características

🔍 Búsqueda web avanzada a través de la API de búsqueda de Jina.ai
🚀 Recuperación de contenido rápida y eficiente
📄 Extracción de texto limpio con estructura preservada
🧠 Contenido optimizado para LLMs
🌐 Soporte para varios tipos de contenido, incluida documentación
🏗️ Construido sobre el Model Context Protocol
🔄 Caché configurable para rendimiento
🖼️ Recopilación opcional de imágenes y enlaces
🌍 Soporte de localización mediante el locale del navegador
🎯 Control del presupuesto de tokens para el tamaño de la respuesta

Configuración

Este servidor requiere configuración a través de tu cliente MCP. Aquí hay ejemplos para diferentes entornos:

Configuración de Cline

Añade esto a tu configuración de MCP de Cline:

{
	"mcpServers": {
		"jinaai-search": {
			"command": "node",
			"args": ["-y", "mcp-jinaai-search"],
			"env": {
				"JINAAI_API_KEY": "your-jinaai-api-key"
			}
		}
	}
}

Configuración de Claude Desktop con WSL

Para entornos WSL, añade esto a tu configuración de Claude Desktop:

{
	"mcpServers": {
		"jinaai-search": {
			"command": "wsl.exe",
			"args": [
				"bash",
				"-c",
				"JINAAI_API_KEY=your-jinaai-api-key npx mcp-jinaai-search"
			]
		}
	}
}

Variables de entorno

El servidor requiere la siguiente variable de entorno:

JINAAI_API_KEY: Tu clave de API de Jina.ai (requerida)

API

El servidor implementa una única herramienta MCP con parámetros configurables:

search

Busca en la web y obtén contenido limpio y amigable para LLMs usando Jina.ai Reader. Devuelve los 5 mejores resultados con URLs y contenido limpio.

Parámetros:

query (string, requerido): Consulta de búsqueda
format (string, opcional): Formato de respuesta ("json" o "texto"). Por defecto "texto"
no_cache (boolean, opcional): Omitir caché para resultados frescos. Por defecto false
token_budget (number, opcional): Número máximo de tokens para esta solicitud
browser_locale (string, opcional): Locale del navegador para renderizar contenido
stream (boolean, opcional): Habilitar modo de transmisión para páginas grandes. Por defecto false
gather_links (boolean, opcional): Recopilar todos los enlaces al final de la respuesta. Por defecto false
gather_images (boolean, opcional): Recopilar todas las imágenes al final de la respuesta. Por defecto false
image_caption (boolean, opcional): Poner subtítulos a las imágenes en el contenido. Por defecto false
enable_iframe (boolean, opcional): Extraer contenido de iframes. Por defecto false
enable_shadow_dom (boolean, opcional): Extraer contenido de shadow DOM. Por defecto false
resolve_redirects (boolean, opcional): Seguir cadenas de redirección hasta la URL final. Por defecto true

Desarrollo

Configuración

Clona el repositorio
Instala las dependencias:

pnpm install

Compila el proyecto:

pnpm run build

Ejecuta en modo de desarrollo:

pnpm run dev

Publicación

Crea un changeset:

pnpm changeset

Versiona el paquete:

pnpm version

Compila y publica:

pnpm release

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Solicitud de extracción.

Licencia

Licencia MIT: consulta el archivo LICENSE para más detalles.

Agradecimientos

Construido sobre el Model Context Protocol
Impulsado por Jina.ai Search API