remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Used for loading API key from environment variables, allowing secure configuration of the Jina AI integration
Serves as the runtime environment for the MCP server, executing the Jina AI integration
Used for defining tool signatures and response formats when interacting with Jina AI's neural search capabilities

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

📋 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

Clonar el repositorio:

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

Instalar dependencias:

npm install

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

JINA_API_KEY=your_api_key_here

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Permite la búsqueda semántica, la búsqueda de imágenes y las funcionalidades de búsqueda intermodal mediante la integración con las capacidades de búsqueda neuronal de Jina AI.

Related Resources

Reddit Discussion about this server

Jina AI MCP Server