diagrams-mcp

# diagrams-mcp ## Descripción diagrams-mcp es un MCP que permite generar diagramas automáticamente a partir de texto o estructuras JSON. Actualmente soporta: * Diagramas de clases (UML) * Diagramas entidad-relación (ER) * Generación mediante texto natural * Exportación a SVG usando Mermaid * Integración pensada para agentes MCP El objetivo es permitir que un agente o usuario describa un sistema y obtener el diagrama correspondiente sin escribir Mermaid manualmente. --- ## Instalación 1. Clonar el repositorio ``` git clone https://github.com/nacho-mazzoni/diagrams-mcp.git cd diagrams-mcp ``` 1. Instalar dependencias ``` npm install ``` 1. Instalar Mermaid CLI (si no está instalado) ``` npm install -g @mermaid-js/mermaid-cli ``` 1. Verificar instalación ``` mmdc -h ``` --- ## Uso Este MCP está diseñado para trabajar junto a un agente. El flujo recomendado es: 1. Pedirle al agente que analice el código del proyecto. 2. Solicitar que el agente genere un JSON con: * Clases detectadas * Entidades * Atributos * Relaciones * Cambios realizados 3. Pasar ese JSON directamente al MCP. 4. El MCP genera automáticamente el diagrama correspondiente. Esto permite que el diagrama se construya a partir del estado real del código o de los cambios introducidos por el agente, sin necesidad de escribir manualmente Mermaid. El MCP acepta: * JSON estructurado generado por el agente * Texto natural describiendo el modelo * Datos parciales para actualizar diagramas existentes --- ## Integración con un agente Un usuario puede integrar diagrams-mcp a su agente siguiendo este flujo: 1. El usuario solicita al agente analizar el código o describir un sistema. 2. El agente genera un JSON estructurado con entidades, clases, atributos y relaciones. 3. El agente envía ese JSON al MCP. 4. diagrams-mcp genera el diagrama automáticamente. 5. El agente devuelve el SVG generado al usuario. Flujo conceptual: ``` Usuario -> Agente -> JSON -> diagrams-mcp -> SVG -> Usuario ``` Esto permite que el diagrama refleje el estado real del código o los cambios realizados por el agente. --- ## Ejemplo de JSON generado por un agente ``` { "entities": [ { "name": "Usuario", "attributes": ["id", "nombre"] }, { "name": "Pedido", "attributes": ["id", "fecha"] } ], "relations": [ { "from": "Usuario", "to": "Pedido", "fromCard": "1", "toCard": "1..*", "label": "realiza" } ] } ``` Ese JSON se pasa directamente al MCP para generar el diagrama. --- ## Estructura del proyecto ``` diagrams-mcp │ ├── tools │ ├── classDiagram.js │ └── erDiagram.js │ ├── parsers │ ├── textToClass.js │ └── textToER.js │ ├── index.js └── package.json ``` --- ## Objetivo del proyecto * Integración con agentes MCP * Generación automática de diagramas durante desarrollo * Soporte para texto natural * Extensión futura a más tipos de diagramas --- ## Estado actual * Diagramas ER con cardinalidad y claves PK y FK * Diagramas de clases UML * Parser desde texto * Exportación SVG --- ## Aclaraciones El MCP también soporta definición de entidades con atributos, claves primarias (PK) y foráneas (FK) mediante bloques de texto separados por líneas en blanco, permitiendo generar diagramas ER completos desde descripciones estructuradas.