Herramientas MCP de Jina AI

Un servidor de Protocolo de Contexto de Modelo (MCP) que se integra con las API de Jina AI Search Foundation.

Características

Este servidor MCP proporciona acceso a las siguientes API de Jina AI:

• Web Reader - Extrae contenido de páginas web usando r.jina.ai

• Web Search - Busca en la web usando s.jina.ai o svip.jina.ai (configurable mediante --search-endpoint)

Related MCP server: Jina Web Search MCP

Requisitos previos

1. Clave de API de Jina AI (Opcional) - Obtenga una clave de API gratuita en https://jina.ai/?sui=apikey para funciones mejoradas

2. Node.js - Versión 16 o superior

Servidor MCP

Uso del transporte stdio (Predeterminado)

Para integraciones locales iniciadas por otro proceso (p. ej., Claude Desktop, VS Code, Cursor):

{
  "mcpServers": {
    "jina-mcp-tools": {
      "command": "npx",
      "args": [
        "jina-mcp-tools",
        "--transport", "stdio",
        "--tokens-per-page", "15000",
        "--search-endpoint", "standard"
      ],
      "env": {
        "JINA_API_KEY": "your_jina_api_key_here_optional"
      }
    }
  }
}

Uso del transporte HTTP

Para implementaciones de servidor remoto accesibles a través de HTTP:

Iniciar el servidor:

# With API key
JINA_API_KEY=your_api_key npx jina-mcp-tools --transport http --host 127.0.0.1 --port 3000

# Without API key (reader tool only, binds to 127.0.0.1 by default)
npx jina-mcp-tools --transport http --port 3000

Conectar desde clientes MCP:

• MCP Inspector: npx @modelcontextprotocol/inspector → http://localhost:3000/mcp

• Claude Code: claude mcp add --transport http jina-tools http://localhost:3000/mcp

• VS Code: code --add-mcp '{"name":"jina-tools","type":"http","url":"http://localhost:3000/mcp"}'

Opciones de CLI:

• --transport - Tipo de transporte: stdio o http (predeterminado: stdio)

• --host - Host/interfaz para enlazar en modo HTTP (predeterminado: 127.0.0.1)

• --port - Puerto del servidor HTTP (predeterminado: 3000, solo para transporte HTTP)

• --tokens-per-page - Tokens por página para paginación (predeterminado: 15000)

• --search-endpoint - Punto final de búsqueda a utilizar: standard (s.jina.ai) o vip (svip.jina.ai) (predeterminado: standard)

• --cache-size - Tamaño de caché del lector en URL (predeterminado: 50)

• --help - Muestra la ayuda integrada de la CLI

Variables de entorno de proxy

Las solicitudes HTTP salientes ahora respetan las variables de entorno de proxy estándar. Esto se aplica a jina_reader, jina_search y jina_search_vip.

• Variables de proxy admitidas: HTTP_PROXY, HTTPS_PROXY, ALL_PROXY

• También se admiten variantes en minúsculas: http_proxy, https_proxy, all_proxy

• Las exclusiones se respetan mediante NO_PROXY / no_proxy

Ejemplo:

HTTPS_PROXY=http://proxy.internal:8080 npx jina-mcp-tools --transport stdio

Herramientas disponibles

jina_reader

Extrae y lee el contenido de una página web.

Parámetros:

• url - URL a leer (obligatorio)

• page - Número de página para contenido paginado (predeterminado: 1)

• customTimeout - Anulación del tiempo de espera en segundos (opcional)

Características:

• Paginación automática para documentos grandes

• Caché LRU (50 URL) para solicitudes de página posteriores instantáneas

• Las URL de archivos de GitHub se convierten automáticamente en URL de contenido sin procesar

• Intenta primero Accept: text/markdown para una lista de permitidos mantenida de hosts de blogs/documentos compatibles con markdown, luego recurre a r.jina.ai en caso de error de recuperación o respuestas vacías

jina_search / jina_search_vip

Busca en la web. Devuelve contenido parcial; use jina_reader para obtener el contenido completo. Requiere clave de API.

La herramienta registrada depende de --search-endpoint:

• jina_search → standard (s.jina.ai, predeterminado)

• jina_search_vip → vip (svip.jina.ai)

Parámetros:

• query - Consulta de búsqueda (obligatorio)

• count - Número de resultados (predeterminado: 5)

• siteFilter - Limitar a un dominio específico (p. ej., "github.com")

Licencia

MIT

Enlaces

• GitHub: https://github.com/PsychArch/jina-mcp-tools

• Problemas: https://github.com/PsychArch/jina-mcp-tools/issues