@diagrammo/dgmo-mcp

MCP-Server zum Rendern von DGMO-Diagrammen. Funktioniert mit Claude Desktop, Claude Code und jedem MCP-kompatiblen KI-Tool.

Tools

preview_diagram

Rendert ein oder mehrere DGMO-Diagramme als SVG und öffnet eine in sich geschlossene HTML-Seite im Standardbrowser. Die Seite enthält einen Umschalter für das helle/dunkle Design und ein responsives SVG-Layout.

Ein einzelnes Diagramm wird als einfache Vorschauseite gerendert. Mehrere Diagramme erzeugen ein Layout im Berichtsformat mit einem Inhaltsverzeichnis (bei >3 Abschnitten). Wenn einige Diagramme nicht gerendert werden können, werden erfolgreiche Diagramme mit Fehler-Platzhaltern für die fehlgeschlagenen angezeigt.

generate_report

Erzeugt einen professionellen HTML-Bericht mit mehreren Abschnitten und öffnet ihn optional im Browser. Enthält einen Titel, einen optionalen Untertitel, ein automatisch generiertes Inhaltsverzeichnis, Beschreibungen pro Abschnitt und eine Fußzeile mit Zeitstempel. Geeignet zum Bündeln von Projektanalysen in einem teilbaren Dokument.

Related MCP server: drawio

Einrichtung

Claude Code

Fügen Sie dies zur .claude/settings.local.json Ihres Projekts hinzu:

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

Claude Desktop

Fügen Sie dies zu ~/Library/Application Support/Claude/claude_desktop_config.json hinzu:

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

Starten Sie Claude Desktop nach dem Speichern neu. Die Tools erscheinen automatisch.

Entwicklung

pnpm install
pnpm build
pnpm typecheck

Um gegen ein unveröffentlichtes @diagrammo/dgmo, das in ../dgmo ausgecheckt ist, zu iterieren, überschreiben Sie die npm-aufgelöste Abhängigkeit nach der Installation mit einem Workspace-Symlink:

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

pnpm install macht den Link rückgängig, führen Sie also pnpm link ../dgmo erneut aus, falls sich Abhängigkeiten ändern.

Veröffentlichung

Releases sind tag-gesteuert über .github/workflows/release.yml:

1. Erhöhen Sie die Version in allen drei Dateien (muss exakt übereinstimmen — der Workflow überprüft dies):

   • package.json → version

   • manifest.json → version

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

2. Committen und taggen:

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

3. Der Workflow führt Typecheck + Build aus, veröffentlicht mit Provenance auf npm, bündelt die .mcpb, veröffentlicht über GitHub OIDC in der MCP-Registry und hängt die .mcpb an ein GitHub-Release an.

Erforderliche Secrets

• NPM_TOKEN — Granulares npm-Zugriffstoken mit Schreibberechtigung für @diagrammo/*. Settings → Secrets and variables → Actions → New repository secret.

Die Authentifizierung für die MCP-Registry verwendet automatisch GitHub OIDC (kein Token erforderlich), da sich das Repository in der diagrammo-Organisation befindet und der Server-Namespace io.github.diagrammo/* lautet.