diag2md-mcp

Model Context Protocol (MCP)-Server, der KI-Codierungsagenten Draw.io-C4- und UML-Architektur-Leitplanken sowie Diagrammkonvertierungsfunktionen bereitstellt.

diag2md-mcp verbindet Draw.io-Architekturdiagramme (.xml, .drawio) mit KI-Codierungsagenten (wie Antigravity, Cursor, Claude Desktop und VS Code-MCP-Clients), indem es C4- und UML-Diagramme in Echtzeit in strukturiertes Mermaid-Markdown konvertiert.

Angetrieben von diag2md.

Hauptfunktionen

• Automatische Workspace-Erkennung: Durchsucht Projektverzeichnisse nach Draw.io-Diagrammdateien, die konfigurierbaren Glob-Mustern entsprechen (**/architecture/**/*.xml, **/*.drawio).

• Hochleistungs-In-Memory-Konvertierung: Konvertiert Draw.io-XML-Modelle in Mermaid-Markdown für C4 und UML im Arbeitsspeicher, ohne den Overhead durch das Starten von Subshell-Prozessen.

• KI-Kontextanbieter (convert_diagrams_read): Liest und konvertiert Diagramme dynamisch, um KI-Codierungsassistenten während Chat-Sitzungen direkt umfangreichen Architekturkontext bereitzustellen.

• Batch-Diagrammsynchronisierung (convert_diagrams_write): Hält die Architekturdokumentation aktuell, indem .md-Dateien neben den Diagrammquellen erzeugt werden.

Related MCP server: drawio-mcp

Schnellstart

Ausführen über npx

Sie können den MCP-Server direkt ausführen, ohne ihn vorab zu installieren:

npx -y diag2md-mcp

Globale Installation

npm install -g diag2md-mcp

MCP-Server-Konfiguration

Um diag2md-mcp mit Ihrem bevorzugten KI-Assistenten oder MCP-Client zu verbinden, fügen Sie den Server zu Ihrer Client-Konfigurationsdatei hinzu (z. B. mcp_config.json, claude_desktop_config.json, Cursor- oder Antigravity-MCP-Einstellungen).

Empfohlen (Global installiertes Paket)

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

Alternative: Lokal erstellte Quelle

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

Alternative: Bei Bedarf über npx

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

MCP-Tools-Referenz

diag2md-mcp stellt KI-Codierungsagenten 3 Kern-Tools zur Verfügung:

Server-Konfiguration

Die MCP-Server-Einstellungen können über Umgebungsvariablen angepasst werden:

Konfigurationsbeispiel mit env-Mustern

Sie können benutzerdefinierte Suchmuster direkt in Ihrer MCP-Server-JSON-Konfiguration über den env-Block konfigurieren:

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

Beispiel für dynamische Tool-Aufrufe mit patterns

KI-Assistenten oder Tools können Suchmuster auch pro Anfrage dynamisch überschreiben:

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

Entwicklung

# 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

Lizenz

MIT © polymatic.ventures