diag2md-mcp

Servidor del Model Context Protocol (MCP) que proporciona a los agentes de codificación de IA salvaguardas arquitectónicas C4 y UML de Draw.io y capacidades de conversión de diagramas.

diag2md-mcp conecta los diagramas de arquitectura de Draw.io (.xml, .drawio) con agentes de codificación de IA (como Antigravity, Cursor, Claude Desktop y clientes MCP de VS Code) al convertir diagramas C4 y UML en Markdown Mermaid estructurado en tiempo real.

Desarrollado con diag2md.

Características principales

• Descubrimiento automatizado del espacio de trabajo: Examina los directorios del proyecto en busca de archivos de diagramas de Draw.io que coincidan con patrones glob configurables (**/architecture/**/*.xml, **/*.drawio).

• Conversión en memoria de alto rendimiento: Convierte modelos XML de Draw.io a Markdown Mermaid C4 y UML en memoria, sin la sobrecarga de crear subprocesos de shell.

• Proveedor de contexto para IA (convert_diagrams_read): Lee y convierte diagramas dinámicamente para proporcionar un contexto arquitectónico enriquecido directamente a los asistentes de codificación de IA durante las sesiones de chat.

• Sincronización por lotes de diagramas (convert_diagrams_write): Mantiene actualizada la documentación de arquitectura generando archivos .md junto a los archivos fuente de los diagramas.

Related MCP server: drawio-mcp

Inicio rápido

Ejecución mediante npx

Puedes ejecutar el servidor MCP directamente sin necesidad de preinstalarlo:

npx -y diag2md-mcp

Instalación global

npm install -g diag2md-mcp

Configuración del servidor MCP

Para conectar diag2md-mcp a tu asistente de IA o cliente MCP favorito, añade el servidor al archivo de configuración de tu cliente (por ejemplo, mcp_config.json, claude_desktop_config.json, Cursor o los ajustes MCP de Antigravity).

Recomendado (paquete instalado globalmente)

{
  "mcpServers": {
    "diag2md-mcp": {
      "command": "diag2md-mcp"
    }
  }
}

Alternativa: código fuente compilado localmente

{
  "mcpServers": {
    "diag2md-mcp": {
      "command": "node",
      "args": ["/path/to/diag2md-mcp/dist/index.js"]
    }
  }
}

Alternativa: bajo demanda mediante npx

{
  "mcpServers": {
    "diag2md-mcp": {
      "command": "npx",
      "args": ["-y", "diag2md-mcp"]
    }
  }
}

Referencia de herramientas MCP

diag2md-mcp expone 3 herramientas principales a los agentes de codificación de IA:

Configuración del servidor

Los ajustes del servidor MCP se pueden personalizar mediante variables de entorno:

Ejemplo de configuración con patrones env

Puedes configurar patrones de búsqueda personalizados directamente en la configuración JSON de tu servidor MCP mediante el bloque env:

{
  "mcpServers": {
    "diag2md-mcp": {
      "command": "diag2md-mcp",
      "env": {
        "DIAG2MD_PATTERNS": "**/architecture/**/*.xml, **/docs/**/*.drawio",
        "DIAG2MD_IGNORE": "**/tmp/**, **/node_modules/**",
        "DIAG2MD_TYPE": "c4"
      }
    }
  }
}

Ejemplo de llamada dinámica a una herramienta con patterns

Los asistentes de IA o las herramientas también pueden anular los patrones de búsqueda dinámicamente en cada solicitud:

{
  "name": "convert_diagrams_read",
  "arguments": {
    "patterns": [
      "**/architecture/**/*.xml",
      "**/docs/**/*.drawio"
    ]
  }
}

Desarrollo

# Clone the repository
git clone https://github.com/diag2md/diag2md-mcp.git
cd diag2md-mcp

# Install dependencies
npm install

# Build TypeScript to JavaScript dist/
npm run build

# Run unit tests
npm run test

# Run type checker
npm run typecheck

Licencia

MIT © polymatic.ventures