@diagrammo/dgmo-mcp

Servidor MCP para renderizar diagramas DGMO. Funciona con Claude Desktop, Claude Code y cualquier herramienta de IA compatible con MCP.

Herramientas

preview_diagram

Renderiza uno o más diagramas DGMO a SVG y abre una página HTML autónoma en el navegador predeterminado. La página incluye un interruptor de tema claro/oscuro y un diseño SVG responsivo.

A single diagram renders as a simple preview page. Multiple diagrams produce a report-style layout with a table of contents (when >3 sections). If some diagrams fail to render, successful ones are shown with error placeholders for the failures.

generate_report

Genera un informe HTML pulido de varias secciones y opcionalmente lo abre en el navegador. Incluye un título, subtítulo opcional, tabla de contenido generada automáticamente, descripciones por sección y un pie de página con marca de tiempo. Adecuado para agrupar el análisis de proyectos en un documento compartible.

Related MCP server: drawio

Configuración

Claude Code

Añadir al archivo .claude/settings.local.json de su proyecto:

{
  "mcpServers": {
    "dgmo": {
      "command": "npx",
      "args": ["-y", "@diagrammo/dgmo-mcp"]
    }
  }
}

Claude Desktop

Añadir a ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "dgmo": {
      "command": "npx",
      "args": ["-y", "@diagrammo/dgmo-mcp"]
    }
  }
}

Reinicie Claude Desktop después de guardar. Las herramientas aparecerán automáticamente.

Desarrollo

pnpm install
pnpm build
pnpm typecheck

Para iterar contra un @diagrammo/dgmo no publicado que se encuentra en ../dgmo, sobrescriba la dependencia resuelta por npm con un enlace simbólico del espacio de trabajo después de la instalación:

pnpm install
pnpm link ../dgmo   # symlink node_modules/@diagrammo/dgmo → ../dgmo
pnpm --filter @diagrammo/dgmo build   # ensure dist/ is up to date

pnpm install deshará el enlace, así que vuelva a ejecutar pnpm link ../dgmo si las dependencias cambian.

Lanzamiento

Los lanzamientos se gestionan mediante etiquetas a través de .github/workflows/release.yml:

1. Aumente la versión en los tres archivos (debe coincidir exactamente — el flujo de trabajo lo verifica):

   • package.json → version

   • manifest.json → version

   • server.json → version y packages[0].version

2. Confirme y etiquete:

   git commit -am "Release vX.Y.Z"
   git tag vX.Y.Z
   git push && git push --tags

3. El flujo de trabajo ejecuta la verificación de tipos + compilación, publica en npm con procedencia, empaqueta el .mcpb, publica en el registro MCP a través de GitHub OIDC y adjunta el .mcpb a un lanzamiento de GitHub.

Secretos requeridos

• NPM_TOKEN — token de acceso granular de npm con alcance de escritura para @diagrammo/*. Configuración → Secretos y variables → Acciones → Nuevo secreto de repositorio.

La autenticación del registro MCP utiliza GitHub OIDC automáticamente (no se necesita token) porque el repositorio está en la organización diagrammo y el espacio de nombres del servidor es io.github.diagrammo/*.