Ilograph MCP Server

Crear y validar diagramas de Ilograph con acceso a documentación y guía.

Documentación

🎯 Ilograph MCP Server

El Ilograph MCP Server es un servidor de Model Context Protocol (MCP) que proporciona a los agentes de IA acceso integral a la documentación de Ilograph, herramientas de validación y orientación para la creación de diagramas. Transforma documentación de arquitectura compleja con asistencia inteligente.

Casos de Uso

Creación Automatizada de Diagramas: Genera diagramas de Ilograph mediante descripciones en lenguaje natural
Validación en Tiempo Real: Valida diagramas existentes con análisis detallado de errores y sugerencias
Acceso a Documentación: Obtén acceso instantáneo a la documentación completa de Ilograph y las mejores prácticas
Aprendizaje y Ejemplos: Explora ejemplos seleccionados de diagramas con explicaciones detalladas

Importante: Este es un proyecto no oficial, impulsado por la comunidad y no está afiliado ni respaldado por Ilograph LLC. El servidor proporciona asistencia educativa y de desarrollo accediendo a la documentación y los recursos públicos de Ilograph.

Precaución: Las salidas y recomendaciones proporcionadas por el servidor MCP se generan dinámicamente y pueden variar según la consulta y el modelo. Los usuarios deben revisar minuciosamente todas las salidas para asegurarse de que se alinean con los requisitos de su proyecto y verificar contra la documentación oficial de Ilograph antes de la implementación.

Requisitos Previos

Docker: Docker instalado y en ejecución
Cliente compatible con MCP: Claude Desktop, VS Code, Cursor, etc.

Inicio Rápido

Añadir a tu Cliente MCP

Añade esta configuración a tu cliente MCP:

VS Code:

Añade el siguiente bloque JSON a tu archivo de Configuración de Usuario (JSON) en VS Code. Puedes hacerlo presionando Ctrl + Shift + P y escribiendo Preferencias: Abrir Configuración de Usuario (JSON).

Más información sobre el uso de las herramientas del servidor MCP en la documentación del modo agente de VS Code.

{
  "mcp": {
    "servers": {
      "ilograph": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "ghcr.io/quincymillerdev/ilograph-mcp-server:latest"
        ]
      }
    }
  }
}

Opcionalmente, puedes añadir un ejemplo similar (es decir, sin la clave mcp) a un archivo llamado .vscode/mcp.json en tu espacio de trabajo. Esto te permitirá compartir la configuración con otros.

{
  "servers": {
    "ilograph": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/quincymillerdev/ilograph-mcp-server:latest"
      ]
    }
  }
}

Claude Desktop / Cursor / Jetbrains AI Assistant:

{
  "mcpServers": {
    "ilograph": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/quincymillerdev/ilograph-mcp-server:latest"]
    }
  }
}

¡Eso es todo! 🎉

Configuración de Herramientas

Herramientas Disponibles

Las siguientes herramientas están disponibles para un soporte integral del flujo de trabajo de Ilograph:

Categoría	Herramienta	Descripción
Documentación	`fetch_documentation_tool`	Obtiene documentación completa de las fuentes oficiales de Ilograph con caché inteligente
Documentación	`list_documentation_sections`	Lista todas las secciones de documentación disponibles con descripciones y áreas de cobertura
Documentación	`check_documentation_health`	Realiza comprobaciones de estado y devuelve estadísticas de caché para el servicio de documentación
Especificación	`fetch_spec_tool`	Obtiene la especificación oficial de Ilograph con definiciones completas de propiedades y tipos
Especificación	`check_spec_health`	Realiza comprobaciones de estado específicamente sobre la conectividad del servicio de especificación
Ejemplos	`list_examples`	Lista los diagramas de ejemplo de Ilograph disponibles categorizados por complejidad y caso de uso
Ejemplos	`fetch_example`	Recupera diagramas de ejemplo específicos con metadatos, contexto de aprendizaje y explicaciones
Validación	`validate_diagram_tool`	Valida la sintaxis de diagramas de Ilograph y proporciona mensajes de error detallados con sugerencias
Validación	`get_validation_help`	Proporciona orientación completa sobre la validación de diagramas y la resolución de problemas comunes
Iconos	`search_icons_tool`	Busca en el catálogo de iconos en vivo de Ilograph con coincidencia semántica y filtrado por proveedor
Iconos	`list_icon_providers_tool`	Lista todos los proveedores de iconos disponibles (AWS, Azure, GCP, etc.) y sus categorías de servicios

Contribuciones

¡Las contribuciones son bienvenidas! Este proyecto necesita:

🐛 Correcciones de errores - ¡Siempre apreciadas!
📚 Mejoras de documentación - Ayuda a aclarar las cosas
✨ Nuevas herramientas - Añade más funcionalidad de Ilograph
🔧 Calidad de código - Mejor manejo de errores, etc.

📖 Consulta CONTRIBUTING.md para obtener instrucciones detalladas de configuración de desarrollo, pruebas y envío de contribuciones.

Características

📚 Acceso a Documentación en Vivo: Obtiene documentación actualizada de las fuentes oficiales de Ilograph
🔍 Cobertura Integral de Secciones: Acceso a todos los conceptos principales de Ilograph (recursos, perspectivas, contextos, etc.)
✅ Validación Avanzada de Diagramas: Validación de esquema YAML e Ilograph con mensajes de error detallados y sugerencias
⚡ Caché Inteligente: Caché basada en TTL con estrategias de respaldo para un rendimiento óptimo
🛠️ Diseño Centrado en Herramientas: Compatible con todos los clientes MCP actuales (Cursor, Claude Desktop, VS Code, etc.)
📋 Biblioteca de Ejemplos Seleccionados: Diagramas de Ilograph del mundo real con contexto de aprendizaje y explicaciones
🎨 Búsqueda Inteligente de Iconos: Búsqueda semántica en el catálogo de iconos de Ilograph con filtrado por proveedor
🔄 Monitoreo de Salud: Comprobaciones de salud del servicio integradas e informes de estado
🏗️ Detección de Patrones de Arquitectura: Identifica patrones comunes y proporciona sugerencias de optimización

¿Necesitas Ayuda?

Uso de Herramientas: Consulta las herramientas disponibles en la tabla anterior
Problemas: GitHub Issues
Preguntas: GitHub Discussions

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.

Aviso Legal

Este proyecto no está afiliado, respaldado ni conectado con Ilograph LLC. Esta es una herramienta independiente impulsada por la comunidad que accede a la documentación y los recursos públicos de Ilograph con fines educativos y de desarrollo.

El nombre Ilograph y las marcas comerciales relacionadas son propiedad de Ilograph LLC
Esta herramienta accede a documentación pública disponible bajo principios de uso justo
Los usuarios deben consultar la documentación oficial de Ilograph para obtener información autoritativa
No existe relación comercial entre este proyecto e Ilograph LLC

Enlaces

Hecho con ❤️ para la comunidad de Ilograph