Servidor Jina AI MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que se integra perfectamente con las funciones de búsqueda neuronal de Jina AI. Este servidor permite la búsqueda semántica, la búsqueda de imágenes y la búsqueda intermodal mediante una interfaz sencilla.

🚀 Características

• Búsqueda semántica : encuentre documentos semánticamente similares mediante consultas en lenguaje natural

• Búsqueda de imágenes : busque imágenes visualmente similares mediante URL de imágenes

• Búsqueda intermodal : realice búsquedas de texto a imagen o de imagen a texto

Related MCP server: Jina Web Search MCP

📋 Requisitos previos

• Node.js 16 o superior

• Una cuenta de Jina AI y una clave API ( Obtén una aquí )

• Entorno compatible con MCP (por ejemplo, Cline)

🛠️ Instalación

1. Clonar el repositorio:

git clone <repository-url>
cd jina-ai-mcp

2. Instalar dependencias:

npm install

3. Cree un archivo .env con su clave API de Jina AI:

JINA_API_KEY=your_api_key_here

4. Construir el servidor:

npm run build

⚙️ Configuración

Agregue la siguiente configuración a su archivo de configuración de MCP:

{
  "mcpServers": {
    "jina-ai": {
      "command": "node",
      "args": [
        "/path/to/jina-ai-mcp/build/index.js"
      ],
      "env": {
        "JINA_API_KEY": "your_api_key_here"
      }
    }
  }
}

🔍 Herramientas disponibles

1. Búsqueda semántica

Realizar búsqueda semántica/neural en documentos de texto.

use_mcp_tool({
  server_name: "jina-ai",
  tool_name: "semantic_search",
  arguments: {
    query: "search query text",
    collection: "your-collection-name",
    limit: 10 // optional, defaults to 10
  }
})

2. Búsqueda de imágenes

Busque imágenes similares utilizando una URL de imagen.

use_mcp_tool({
  server_name: "jina-ai",
  tool_name: "image_search",
  arguments: {
    imageUrl: "https://example.com/image.jpg",
    collection: "your-collection-name",
    limit: 10 // optional, defaults to 10
  }
})

3. Búsqueda intermodal

Realizar búsqueda de texto a imagen o de imagen a texto.

use_mcp_tool({
  server_name: "jina-ai",
  tool_name: "cross_modal_search",
  arguments: {
    query: "a beautiful sunset", // or image URL for image2text
    mode: "text2image", // or "image2text"
    collection: "your-collection-name",
    limit: 10 // optional, defaults to 10
  }
})

Formato de respuesta

Todas las herramientas de búsqueda devuelven resultados en el siguiente formato:

{
  content: [
    {
      type: "text",
      text: JSON.stringify({
        results: [
          {
            id: string,
            score: number,
            data: Record<string, any>
          }
        ]
      }, null, 2)
    }
  ]
}

🔐 Manejo de errores

El servidor maneja varios casos de error:

• Clave API no válida

• Parámetros faltantes o no válidos

• Límites de velocidad de la API

• Errores de red

• Nombres de colección no válidos

Todos los errores se formatean correctamente y se devuelven con los códigos de error y mensajes apropiados.

🤝 Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

📄 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

🙏 Agradecimientos

• Jina AI por su excelente plataforma de búsqueda neuronal

• Protocolo de contexto de modelo para la especificación MCP