Rakson0209/enterprise-knowledge-mcp-server-speckit

Base de conocimiento empresarial lista para producción (DOCX/PDF/PPTX) con análisis Docling que preserva la estructura, fragmentación semántica completa con metadatos y recuperación híbrida Dense+BM25/RRF, expuesta como un Servidor MCP Remoto (FastMCP). Incluye una habilidad reutilizable de preprocesamiento de documentos para Claude. Desplegado en Zeabur (ARM64, solo CPU).

¿Qué es enterprise-knowledge-mcp-server-speckit?

Este skill proporciona un servidor MCP (Model Context Protocol) remoto y listo para producción, diseñado para gestionar una base de conocimiento empresarial a partir de documentos en formatos DOCX, PDF y PPTX. Utiliza el analizador Docling para extraer y preservar la estructura completa de los documentos, incluyendo tablas, imágenes y formato de texto. Luego, aplica una fragmentación semántica que mantiene todos los metadatos, y emplea un sistema de recuperación híbrido que combina búsqueda densa (Dense) con BM25 (recuperación clásica) y un mecanismo de fusión RRF (Reciprocal Rank Fusion) para obtener resultados de alta relevancia. El servidor se expone a través de FastMCP, permitiendo su integración remota con asistentes de IA como Claude. Además, incluye una habilidad de preprocesamiento de documentos reutilizable para Claude, facilitando la preparación de documentos para su ingesta. Está desplegado en Zeabur con arquitectura ARM64 y solo CPU, optimizado para entornos de producción empresarial.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add Rakson0209/enterprise-knowledge-mcp-server-speckit

Installed? Explore more Investigación y análisis de datos skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace enterprise-knowledge-mcp-server-speckit?

Base de conocimiento empresarial lista para producción (DOCX/PDF/PPTX) con análisis Docling que preserva la estructura, fragmentación semántica completa con metadatos y recuperación híbrida Dense+BM25/RRF, expuesta como un Servidor MCP Remoto (FastMCP). Incluye una habilidad reutilizable de preprocesamiento de documentos para Claude. Desplegado en Zeabur (ARM64, solo CPU).

Visión General

Este servidor MCP remoto permite a los asistentes de IA (como Claude) indexar y consultar documentos empresariales de manera eficiente. Al combinar un análisis estructural profundo con un sistema de recuperación híbrida, garantiza que las respuestas generadas por la IA estén fundamentadas en el contenido más relevante de la base de conocimiento, preservando el contexto y la integridad de la información original.

Características Principales

  • Análisis de Documentos con Docling: Extrae texto, tablas, imágenes y estructura de documentos DOCX, PDF y PPTX manteniendo fidelidad.
  • Fragmentación Semántica con Metadatos: Divide los documentos en fragmentos con significado completo, conservando metadatos como título, autor, número de página y sección.
  • Recuperación Híbrida Dense+BM25/RRF: Combina la potencia de la búsqueda semántica (Dense) con la robustez de BM25, fusionando los resultados mediante RRF para una precisión superior.
  • Servidor MCP Remoto (FastMCP): Se integra de forma remota con clientes MCP como Claude, permitiendo consultas en tiempo real.
  • Habilidad de Preprocesamiento para Claude: Incluye una habilidad reutilizable que prepara y limpia documentos antes de su ingesta.
  • Despliegue Optimizado: Ejecutándose en Zeabur con arquitectura ARM64 y solo CPU, listo para entornos de producción.

Plataformas Soportadas

  • Clientes MCP: Claude Desktop, Claude Code, Cursor y otros asistentes compatibles con MCP.
  • Formularios de Documentos: DOCX, PDF, PPTX.
  • Infraestructura de Despliegue: Zeabur (ARM64, CPU-only).

Cómo Funciona

  1. Ingesta de Documentos: Los documentos se procesan mediante Docling, que analiza su estructura y extrae el contenido.
  2. Fragmentación: El contenido se divide en fragmentos semánticos, cada uno con sus metadatos asociados.
  3. Indexación Híbrida: Los fragmentos se indexan tanto en un índice denso (embeddings) como en un índice BM25.
  4. Consulta: Cuando un usuario formula una pregunta, el sistema ejecuta una búsqueda híbrida que combina los resultados de ambos índices y los fusiona usando RRF.
  5. Respuesta: Los fragmentos más relevantes se devuelven al asistente de IA, que genera una respuesta contextual basada en ellos.

Uso

Configuración del Cliente MCP

Para conectar este servidor desde Claude Desktop o Claude Code, añade la siguiente configuración a tu archivo cline_mcp_settings.json o claude_desktop_config.json:

{
  "mcpServers": {
    "enterprise-knowledge": {
      "type": "remote",
      "url": "https://tu-servidor-zeabur.up.railway.app/sse"
    }
  }
}

Habilidad de Preprocesamiento de Documentos (Claude Skill)

El skill de preprocesamiento se puede invocar en Claude para limpiar y preparar documentos antes de subirlos al servidor. Ejemplo de uso:

Preprocesa el documento 'informe.pdf' usando la habilidad de preprocesamiento de documentos.

Variables de Entorno (Opcionales)

VariableDescripciónValor por Defecto
DOCLING_BASE_PATHRuta base para archivos temporales de Docling/tmp
CHUNK_SIZETamaño máximo de fragmentos (en tokens)512
CHUNK_OVERLAPSuperposición entre fragmentos128
TOP_KNúmero de fragmentos a recuperar10

Repositorio y Licencia

Notas Técnicas

  • El servidor está optimizado para CPU, no requiere GPU.
  • Se recomienda utilizar el preprocesamiento para documentos con escaneos de baja calidad o formatos mixtos.
  • Para problemas o solicitudes, abre un issue en el repositorio de GitHub.

Skills relacionados