Servidor MCP de RAG multimodal Calypso

El servidor MCP de RAG multimodal alojado más fácil para Claude Desktop, Cursor y flujos de trabajo de agentes.

Un solo comando npx. Impulsado por Gemini File Search. Maneja PDF, capturas de pantalla, gráficos, diagramas e imágenes de forma nativa con citas verificables.

La forma más fácil de añadir RAG multimodal alojado a Claude, Cursor, Windsurf y agentes personalizados.

• Configuración súper simple: npx -y @calypsohq/multimodal-rag-mcp-server --api-key sk-your-key-here

• RAG multimodal real: maneja texto y elementos visuales de forma nativa mediante Gemini File Search

• Sube y consulta: herramientas dedicadas para archivos de conocimiento duraderos y cargas por lotes

• Conversaciones de varios turnos: respuestas conscientes del contexto con reinicio /new

• Flujos de trabajo descubribles: recursos y prompts para flujos seguros de RAG, carga e ingesta

GitHub | Docs | Smithery | Registro oficial de MCP

Etiquetas: multimodal-rag, easiest-mcp-rag, gemini-rag, hosted-rag-mcp, mcp-server

En lugar de conectar cada agente o flujo de trabajo a una pila de búsqueda de documentos puntual, usa este MCP como punto de entrada orientado a agentes para una capa de respuestas reutilizable: sube el material fuente una vez, recupera contenido de texto y visual, y devuelve respuestas con evidencia que los usuarios puedan verificar.

Inicio rápido (lo más fácil)

# One-liner with npx
npx -y @calypsohq/multimodal-rag-mcp-server --api-key "sk-your-key-here"

O con variables de entorno:

CALYPSO_API_KEY="sk-..." npx -y @calypsohq/multimodal-rag-mcp-server

Luego añade el mismo comando a Claude Desktop, Cursor o Smithery usando los ejemplos de configuración a continuación.

Related MCP server: RAG-Anything MCP Server

Por qué elegir Calypso

Calypso está diseñado para equipos que quieren el servidor MCP de RAG multimodal alojado más fácil: sin pila vectorial local, sin Docker Compose y sin pipeline personalizado de OCR o procesamiento de imágenes antes de que los agentes puedan hacer preguntas fundamentadas.

Empieza aquí si quieres el servidor MCP de RAG multimodal alojado más fácil.

Lo que obtienes

• Agente RAG multimodal de producción con memoria de varios turnos

• Herramientas de carga integradas para archivos individuales y cargas de conocimiento por lotes

• Descubrimiento automático de las variantes de RAG y los buckets de conocimiento de tu equipo

• Citas verificables con referencias de fuentes y metadatos de recuperación

• Recursos de solo lectura y prompts reutilizables para flujos de trabajo seguros

Por qué RAG multimodal primero

La mayor parte del conocimiento empresarial no es solo texto. La respuesta a menudo vive en una captura de pantalla de configuración, una tabla en PDF, un diagrama de producto, una página del centro de ayuda o un gráfico dentro de un informe. Calypso empaqueta toda esa superficie de conocimiento en una única capa de recuperación para que los agentes puedan hacer preguntas fundamentadas sin adivinar a partir de la memoria genérica del modelo.

• Busca los formatos en los que los usuarios realmente confían: documentación, PDF, capturas de pantalla, gráficos, diagramas, imágenes de producto, artículos de soporte, manuales, políticas, preguntas frecuentes e informes.

• Fundamenta las respuestas antes de que el modelo escriba: Gemini File Search recupera primero el contexto de texto y visual relevante, luego el agente RAG responde a partir de ese material fuente.

• Muestra el rastro de evidencia: las respuestas pueden incluir referencias de fuentes, fundamentación consciente de la página y metadatos de recuperación para que las personas puedan verificar antes de confiar.

• Acota la recuperación con metadatos: usa espacio de trabajo, equipo, cliente, idioma, tipo de archivo, estado u otros metadatos para mantener las respuestas relevantes sin duplicar bases de conocimiento.

• Reutiliza la misma capa de conocimiento en todas partes: conecta Cursor, Claude Desktop, agentes de IA, flujos de n8n, interfaz de producto, flujos de soporte y experiencias web a la misma capa respaldada por fuentes.

En la práctica, esto significa que tu agente puede responder preguntas como:

• "Explica esta captura de pantalla de configuración y el PDF de política adjunto. ¿Qué debería hacer el representante de soporte a continuación?"

• "¿Qué dice este PDF de incorporación sobre las reglas de aprobación?"

• "¿Por qué falla esta pantalla de configuración?"

• "Compara el gráfico de precios con nuestra documentación de planes y recomienda el nivel adecuado."

• "Resume la política que se aplica a este ticket de soporte."

• "¿Qué plan de producto se ajusta a este cliente según nuestros documentos de precios?"

• "Compara el flujo de ingesta diagramado con el flujo de recuperación."

Qué hace este MCP

Con calypso-rag-agent puedes:

• Hacer preguntas fundamentadas contra la base de conocimiento de Calypso configurada

• Seleccionar cualquier variante de RAG de equipo descubierta con el argumento opcional model

• Continuar una conversación de varios turnos mediante el modelo de conversación nativo /v1/responses

• Restablecer el contexto de la conversación con /new

• Usar el mismo endpoint de Responses compatible con OpenAI que sirve a calypso-rag-agent

• Descubrir recursos y prompts integrados para los flujos de trabajo de Calypso compatibles

Requisitos

• Node.js 18+

• El servidor usa primitivas de Web Fetch API (fetch, Headers, Request, Response, FormData, Blob y File) para llamadas API y compatibilidad con el SDK. El paquete arranca los globales faltantes al inicio para entornos de ejecución MCP que exponen solo parte de la superficie de Web API de Node 18+.

• Un endpoint de API de Calypso que exponga:

  • POST /v1/responses

  • GET /v1/rag-agent/models

  • GET /v1/knowledge/buckets

  • POST /v1/knowledge/files/upload-session

  • POST /v1/knowledge/files/upload-session/{session_id}/finalize

  • POST /v1/knowledge/files:batch/upload-session

  • POST /v1/knowledge/files:batch/upload-session/{batch_id}/finalize

  • GET /v1/knowledge/batches/{batch_id}

• Una clave de API de Calypso (sk-...)

Configuración

Variables de entorno:

• CALYPSO_API_KEY (obligatoria)

• CALYPSO_API_BASE_URL (opcional, por defecto https://api.calypso.so/v1)

Banderas de CLI:

• --api-key

• --api-base-url

Precedencia de configuración:

1. Banderas de CLI / argumentos de comando proporcionados por Smithery

2. Variables de entorno

3. URL base por defecto (https://api.calypso.so/v1)

Ejecutar con npx

npx -y @calypsohq/multimodal-rag-mcp-server --api-key "sk-..."

Ejecutar con variables de entorno

env CALYPSO_API_KEY="sk-..." CALYPSO_API_BASE_URL="https://api.calypso.so/v1" npx -y @calypsohq/multimodal-rag-mcp-server

Configurar en Cursor

Añade un nuevo servidor MCP (tipo comando) como:

npx -y @calypsohq/multimodal-rag-mcp-server --api-key sk-... --api-base-url https://api.calypso.so/v1

Configurar en Claude Desktop

1. Abre la configuración de MCP de Claude Desktop

En Claude Desktop:

Claude -> Configuración -> Desarrollador -> Editar configuración

En macOS, el archivo suele estar en:

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

Claude Desktop usa claude_desktop_config.json para servidores MCP de escritorio. Claude Code usa ubicaciones de configuración separadas como ~/.claude.json o .mcp.json a nivel de proyecto.

2. Añade el servidor MCP de Calypso

Pega esto en claude_desktop_config.json:

{
  "mcpServers": {
    "Calypso Multimodal RAG": {
      "command": "npx",
      "args": [
        "-y",
        "@calypsohq/multimodal-rag-mcp-server"
      ],
      "env": {
        "CALYPSO_API_KEY": "sk-your-calypso-api-key",
        "CALYPSO_API_BASE_URL": "https://api.calypso.so/v1"
      }
    }
  }
}

Reemplaza:

• sk-your-calypso-api-key

con tu clave de API real de Calypso.

3. Reinicia Claude Desktop por completo

Sal de Claude Desktop por completo y luego vuelve a abrirlo.

No solo cierres la ventana. En macOS:

Cmd + Q

Después del reinicio, el MCP debería aparecer en Claude con estas herramientas disponibles:

• calypso-rag-agent

• calypso-list-buckets

• calypso-upload-file

• calypso-upload-files-batch

Opcional: guardar artefactos de Claude en tu Mac

Calypso proporciona herramientas de RAG multimodal alojado. No escribe informes generados, resúmenes, CSV, archivos JSON o artefactos de búsqueda web directamente en tu computadora local.

Para permitir que Claude Desktop guarde archivos generados localmente, añade el servidor MCP de sistema de archivos estándar junto a Calypso y restringe su acceso a una carpeta segura dedicada.

Crea la carpeta primero:

mkdir -p ~/Claude

Luego añade ambos servidores a claude_desktop_config.json:

{
  "mcpServers": {
    "Calypso Multimodal RAG": {
      "command": "npx",
      "args": [
        "-y",
        "@calypsohq/multimodal-rag-mcp-server"
      ],
      "env": {
        "CALYPSO_API_KEY": "sk-your-calypso-api-key",
        "CALYPSO_API_BASE_URL": "https://api.calypso.so/v1"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Claude"
      ]
    }
  }
}

Sal y vuelve a abrir Claude Desktop después de cambiar la configuración.

Ejemplo de prompt:

Use Calypso for the grounded RAG answer, then save the final report as /Users/yourname/Claude/report.md using the filesystem tool.

Por seguridad, solo otorga acceso al sistema de archivos a una carpeta dedicada como ~/Claude, no a todo tu directorio de inicio.

Smithery

El servidor está disponible en Smithery y se lanza a través de la misma ruta de paquete npx que usan los clientes de escritorio.

Configuración de usuario de Smithery:

• calypsoApiKey (obligatoria)

• calypsoApiBaseUrl (opcional, por defecto https://api.calypso.so/v1)

La ruta de lanzamiento de Smithery es equivalente a:

npx -y @calypsohq/multimodal-rag-mcp-server --api-key sk-... --api-base-url https://api.calypso.so/v1

Usa calypsoApiBaseUrl solo cuando apuntes a una implementación autoalojada compatible con Calypso. El valor predeterminado en la nube no necesita anulación.

Solución de problemas

• Falta la clave de API: proporciona --api-key o CALYPSO_API_KEY

• Host de API incorrecto: asegúrate de que --api-base-url / CALYPSO_API_BASE_URL termine en /v1

• Despliegue autoalojado: solo sobrescribe la URL base si no estás usando https://api.calypso.so/v1

• Desajuste de lanzamiento de Smithery: usa la ruta empaquetada npx -y @calypsohq/multimodal-rag-mcp-server en lugar de ejecutar node dist/index.js desde un clon reciente

• FormData is not defined o Headers is not defined: actualiza al último paquete. El servidor MCP inicializa los globales de la Web Fetch API que faltan antes de que se ejecuten las herramientas de subida.

• ENOENT para /mnt/user-data/uploads/...: esa ruta pertenece a un agente alojado o a un sandbox de adjuntos, no necesariamente al servidor MCP. Reintenta con contentBase64 en lugar de filePath.

• Guardado de artefactos local: las respuestas de Calypso se pueden usar con el servidor MCP de sistema de archivos de Claude Desktop, pero hay que pedirle explícitamente a Claude que guarde la salida final en una ruta local permitida.

Elegir entre filePath y contentBase64

Usa filePath para instalaciones MCP locales, incluidas las configuraciones de Claude Desktop y Cursor que lanzan este paquete con un comando local como:

npx -y @calypsohq/multimodal-rag-mcp-server

En esa configuración, el proceso del servidor MCP se ejecuta en tu máquina y puede leer rutas disponibles para la misma cuenta de usuario. Pasa la ruta local directamente; el servidor lee los bytes sin procesar y los sube a través de la URL de sesión de subida de Calypso. No necesitas codificar en base64 los archivos locales.

Usa contentBase64 para clientes MCP alojados o remotos, incluidos servidores alojados en Smithery, entornos de ejecución de navegador/cloud, contenido generado en memoria y contenedores de agentes. En esos entornos, una ruta en tu Mac o estación de trabajo no es legible por el proceso del servidor MCP.

Si una ruta comienza con /mnt/user-data/uploads, /mnt/data, /mnt/attachments u otro prefijo de sandbox alojado, no la envíes como filePath a menos que este servidor MCP se esté ejecutando en ese mismo sandbox. Usa contentBase64 u otra fuente de bytes en línea en su lugar.

Herramientas disponibles

calypso-rag-agent

Acceso directo al agente RAG de Calypso.

Notas:

• No enruta automáticamente a otras personas o agentes.

• Descubre automáticamente las variantes calypso-rag-agent disponibles para la clave de API al iniciar.

• Usa el argumento opcional model para elegir una variante con nombre como calypso-rag-agent:pricing.

• Cada variante de modelo mantiene su propia cadena de conversación MCP, por lo que cambiar de variante no continúa el hilo incorrecto.

• Usa POST /v1/responses en lugar de POST /v1/chat/completions.

• Los primeros turnos crean una conversación con nombre, y los turnos de seguimiento se encadenan con previous_response_id.

• Se admiten fileIds opcionales para preguntas con ámbito de recuperación. Las nuevas subidas deben usar las herramientas de subida de conocimiento duradero y esperar a la indexación antes de preguntar.

• Usa /new como prompt para restablecer la conversación MCP.

calypso-list-buckets

Lista los buckets para el equipo vinculado a la clave de API de Calypso configurada.

Notas:

• Usa GET /v1/knowledge/buckets.

• No acepta team_id; Calypso deriva el ámbito del equipo de la clave de API.

• Devuelve ids de bucket, slugs, nombres, estado, recuentos de miembros, recuentos de fuentes y preparación del almacén de buckets.

• Por defecto solo devuelve buckets activos. Pasa includeArchived: true cuando necesites buckets archivados para auditorías o limpieza.

• Úsalo antes de calypso-upload-file o calypso-upload-files-batch cuando necesites elegir un bucket de destino.

• calypso://rag-agent-models responde qué buckets están vinculados a cada variante RAG. calypso-list-buckets responde qué buckets existen para el equipo de la clave de API.

Ejemplo:

{
  "includeArchived": false
}

calypso-get-file

Obtiene los metadatos y el estado de indexación de un archivo de conocimiento por id de archivo.

Notas:

• Usa GET /v1/knowledge/files/{file_id}.

• Resuelve los fileIds opacos de calypso-list-buckets en nombre de archivo, tipo MIME, tamaño, estado de indexación y estado de sincronización por bucket.

• Pasa verify: true para verificar de forma cruzada con el proveedor (?verify=gemini) — más lento, pero autoritativo cuando un estado parece desactualizado.

Ejemplo:

{
  "fileId": "file_123",
  "verify": true
}

calypso-create-bucket

Crea un bucket vacío para el flujo de trabajo de crear y luego llenar.

Notas:

• Usa POST /v1/knowledge/buckets (requiere un backend con este endpoint desplegado y la capacidad knowledge:bucket:create en la clave de API).

• El servidor normaliza el slug; las colisiones devuelven un error tipado bucket_slug_exists.

• Las repeticiones de idempotencyKey devuelven el bucket existente en lugar de dar un error.

• Las subidas aún pueden crear buckets implícitamente mediante bucketSlugs + createMissingBuckets; esta herramienta existe para crear primero el destino.

Ejemplo:

{
  "name": "Product docs",
  "slug": "product-docs",
  "idempotencyKey": "create-product-docs-1"
}

calypso-create-agent

Crea una variante de agente RAG vinculada a uno o más buckets.

Notas:

• Usa POST /v1/rag-agent/agents (requiere un backend con este endpoint desplegado y la capacidad rag:agent:create en la clave de API).

• El payload de éxito comienza con model — pásalo directamente a calypso-rag-agent.

• Los vínculos de bucket se validan en el servidor: los buckets desconocidos o archivados devuelven bucket_not_found; las colisiones de id de agente devuelven agent_id_exists; el límite de agentes del plan devuelve agent_limit_reached.

• Crear un agente actualiza el catálogo de modelos y emite notificaciones MCP tools/list_changed + resources/list_changed, por lo que la nueva variante se puede usar sin reconectar.

Ejemplo:

{
  "agentId": "support",
  "name": "Support agent",
  "bucketSlugs": ["product-docs"],
  "idempotencyKey": "create-support-agent-1"
}

calypso-upload-file

Sube un archivo al almacén de conocimiento duradero respaldado por buckets y a la canalización de indexación.

Notas:

• Usa POST /v1/knowledge/files/upload-session, sube los bytes directamente al almacenamiento y luego finaliza con POST /v1/knowledge/files/upload-session/{session_id}/finalize.

• Las subidas usan solicitudes de sesión JSON más PUT binarios firmados, no subidas de formulario multipart.

• Devuelve metadatos de archivo y tarea, no un file_id de adjunto de chat.

• Requiere un destino de bucket mediante bucketIds, bucketSlugs o bucket.

• Usa filePath para instalaciones MCP locales de Claude Desktop/Cursor donde el servidor puede leer la ruta. Usa contentBase64 para clientes MCP alojados o remotos que no pueden leer rutas locales.

• Si un agente ve una ruta como /mnt/user-data/uploads/file.pdf, no debe enviarla como filePath; debe enviar los bytes del archivo como contentBase64.

• Admite title, tags, metadata e idempotencyKey opcionales.

• Enruta las subidas a buckets existentes con bucketIds o bucketSlugs, o usa bucket como atajo de un solo slug.

• Pasa createMissingBuckets: true con slugs de bucket cuando quieras que Calypso cree destinos faltantes durante la subida.

• Puede esperar opcionalmente hasta que la indexación alcance un estado listo antes de devolver.

Ejemplo:

{
  "filename": "handbook.pdf",
  "mimeType": "application/pdf",
  "filePath": "/Users/me/Documents/handbook.pdf",
  "bucket": "support-handbook",
  "createMissingBuckets": true,
  "waitForIndexing": true
}

calypso-upload-files-batch

Sube de 1 a 100 archivos al almacén de conocimiento duradero en una sola solicitud.

Notas:

• Usa POST /v1/knowledge/files:batch/upload-session, sube cada elemento aceptado directamente al almacenamiento y luego finaliza con POST /v1/knowledge/files:batch/upload-session/{batch_id}/finalize.

• Las subidas usan solicitudes de sesión JSON más PUT binarios firmados, no subidas de formulario multipart.

• Requiere batchIdempotencyKey; Calypso lo usa para derivar el id de lote duradero para reintentos.

• Requiere un destino de bucket compartido mediante bucketIds, bucketSlugs o bucket, salvo que cada elemento proporcione su propio destino de bucket.

• Admite valores predeterminados compartidos bucketIds, bucketSlugs, bucket y createMissingBuckets, además de anulaciones por elemento.

• Usa filePath por elemento para instalaciones MCP locales de Claude Desktop/Cursor donde el servidor puede leer cada ruta. Usa contentBase64 por elemento para clientes MCP alojados o remotos que no pueden leer rutas locales.

• Genera valores client_file_id seguros para Firestore cuando se omite clientFileId.

• accepted o queued significa que la subida es duradera, no necesariamente lista para consultas. Usa waitForBatchReady: true para sondear GET /v1/knowledge/batches/{batch_id}?include_items=true.

• Inspecciona el estado por elemento, bucketSyncStatus y bucketSync para distinguir el contenido indexado de la recuperación lista para bucket.

Ejemplo:

{
  "batchIdempotencyKey": "kb-seed-2026-06-04",
  "bucket": "support-handbook",
  "createMissingBuckets": true,
  "items": [
    {
      "filename": "faq.txt",
      "mimeType": "text/plain",
      "filePath": "/Users/me/Documents/faq.txt"
    }
  ],
  "waitForBatchReady": true
}

Recursos disponibles

calypso://server-info

Metadatos de servidor de solo lectura, incluidos la versión del paquete, la URL base de la API, el transporte, el modelo de autenticación y las capacidades expuestas.

calypso://rag-agent-models

Catálogo de solo lectura en tiempo de ejecución de las variantes de modelo calypso-rag-agent con ámbito de equipo descubiertas desde la clave de API configurada, incluidos los buckets, bucket_ids y missing_bucket_ids activos de cada variante. Si la detección no está disponible, este recurso recurre al calypso-rag-agent base.

calypso://buckets

Lista de solo lectura en tiempo de ejecución de los buckets de conocimiento para el equipo vinculado a la clave de API configurada. Úsala para inspeccionar ids/slugs de bucket y la preparación del almacén de buckets antes de las subidas.

calypso://workflows

Una guía compacta de los flujos de trabajo RAG y de subida de archivos admitidos.

calypso://security

Notas de seguridad operativas para claves de API, lecturas de archivos locales, subidas y registro.

Prompts disponibles

• calypso-question: redacta una pregunta de base de conocimiento fundamentada para calypso-rag-agent

• calypso-ingestion: prepara una subida duradera al almacén de conocimiento y una consulta de seguimiento

• calypso-reset-conversation: inicia un hilo RAG limpio con /new

Flujos de trabajo habituales (copiar/pegar)

Recuperación de conocimiento

• Resumir un tema:

  • Summarize the knowledge base guidance for campaign approvals

• Pedir una respuesta específica:

  • What does our documentation say about indexing retries?

• Comparar dos conceptos:

  • Compare file indexing with retrieval execution in the current architecture

• Iniciar un hilo nuevo:

  • /new

Seguimiento de varios turnos

• Refinar una respuesta anterior:

  • Focus only on the ingestion path and ignore retrieval

• Pedir fuentes o justificación:

  • Explain which documented components are involved and why

Flujo de archivos del almacén de conocimiento

• Descubrir buckets:

  • Llama a calypso-list-buckets o lee calypso://buckets antes de elegir un destino

• Subir conocimiento duradero:

  • Llama a calypso-upload-file con el payload del archivo y title, tags o metadata opcionales

  • Prefiere filePath para instalaciones MCP locales de Claude Desktop/Cursor; usa contentBase64 para clientes MCP alojados o remotos que no pueden leer rutas locales

• Enrutar conocimiento hacia los buckets:

  • Usa bucket: "support-handbook" para un destino, bucketSlugs para múltiples destinos basados en slug, o bucketIds cuando ya tengas ids de bucket estables

• Crear destinos de bucket bajo demanda:

  • Añade createMissingBuckets: true cuando uses asignación de bucket basada en slug y el destino puede que no exista aún

• Esperar la indexación:

  • Pasa waitForIndexing: true si quieres que la herramienta se bloquee hasta que el archivo de conocimiento esté indexado

Flujo de lote del almacén de conocimiento

• Subir muchos archivos duraderos:

  • Llama a calypso-upload-files-batch con items, batchIdempotencyKey y filePath por elemento para instalaciones MCP locales; usa contentBase64 por elemento para clientes MCP alojados o remotos

• Enrutar el lote hacia los buckets:

  • Pon bucket, bucketSlugs, bucketIds o createMissingBuckets compartidos en la llamada a la herramienta, y luego anula por elemento solo cuando sea necesario

• Esperar la preparación para consultas:

  • Usa waitForBatchReady: true e inspecciona el estado del elemento devuelto y los campos de sincronización de bucket antes de consultar contenido nuevo

Consejos

• Empezar de nuevo: usa /new para restablecer la conversación MCP (nuevo conversation_id + cadena de respuesta borrada)