Jina AI MCP Server

Jina AI MCP Server

Un servidor MCP que proporciona acceso a los potentes servicios web de Jina AI a través de Claude. Este servidor implementa tres herramientas principales:

• Lectura de páginas web y extracción de contenido
• Búsqueda web
• Verificación de hechos / fundamentación

Características

Herramientas

read_webpage

• Extrae contenido de páginas web en un formato optimizado para LLMs
• Soporta múltiples formatos de salida (Default, Markdown, HTML, Text, Screenshot, Pageshot)
• Opciones para incluir enlaces e imágenes
• Capacidad para generar texto alternativo para imágenes
• Opciones de control de caché

search_web

• Busca en la web usando la API de búsqueda de Jina AI
• Número configurable de resultados (por defecto: 5)
• Soporte para retención de imágenes y generación de texto alternativo
• Múltiples formatos de retorno (markdown, text, html)
• Devuelve resultados estructurados con títulos, descripciones y contenido

fact_check

• Verifica afirmaciones usando el motor de fundamentación de Jina AI
• Proporciona puntuaciones de factualidad y evidencia de apoyo
• Modo de inmersión profunda opcional para un análisis más exhaustivo
• Devuelve referencias con citas clave y clasificación de apoyo/contradicción

Configuración

Requisitos previos

Necesitarás una clave de API de Jina AI para usar este servidor. Obtén una gratis en https://jina.ai/

Instalación

Hay dos formas de usar este servidor:

Instalación mediante Smithery

Para instalar Jina AI para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install jina-ai-mcp-server --client claude

Opción 1: NPX (Recomendado)

Añade esta configuración a tu archivo de configuración de Claude Desktop:

{
  "mcpServers": {
    "jina-ai-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "jina-ai-mcp-server"
      ],
      "env": {
        "JINA_API_KEY": "<YOUR_KEY>"
      }
    }
  }
}

Opción 2: Instalación local

1. Clona el repositorio
2. Instala las dependencias:

npm install

3. Compila el servidor:

npm run build

4. Añade esta configuración a tu configuración de Claude Desktop:

{
  "mcpServers": {
    "jina-ai-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/jina-ai-mcp-server/dist/index.js"
      ],
      "env": {
        "JINA_API_KEY": "<YOUR_KEY>"
      }
    }
  }
}

Ubicación del archivo de configuración

En MacOS:

~/Library/Application Support/Claude/claude_desktop_config.json

En Windows:

%APPDATA%/Claude/claude_desktop_config.json

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser desafiante. Recomendamos usar el MCP Inspector:

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en tu navegador.

Tipos de respuesta de la API

Todas las herramientas devuelven respuestas JSON estructuradas que incluyen:

• Códigos de estado y metadatos
• Contenido formateado según el tipo de salida solicitado
• Información de uso (conteos de tokens)
• Cuando corresponda: imágenes, enlaces y metadatos adicionales

Para información detallada del esquema, consulta schemas.ts.

Ejecución de evaluaciones

El paquete de evaluaciones carga un cliente MCP que luego ejecuta el archivo index.ts, por lo que no es necesario reconstruir entre pruebas. Puedes cargar variables de entorno prefijando el comando npx. La documentación completa se puede encontrar aquí.

OPENAI_API_KEY=your-key  npx mcp-eval evals.ts index.ts