diag2md-mcp
Officialdiag2md-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-mcpGlobale Installation
npm install -g diag2md-mcpMCP-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:
Tool-Name | Beschreibung | Argumente |
| Findet alle Draw.io-Architekturdiagrammdateien ( |
|
| Scannt Workspace-Diagrammdateien, die Glob-Mustern entsprechen, im Batch-Modus, konvertiert sie und schreibt aktualisierte |
|
| Scannt Workspace-Diagrammdateien im Batch-Modus und gibt konvertiertes Mermaid-Markdown direkt als Kontext für den KI-Assistenten zurück. |
|
Server-Konfiguration
Die MCP-Server-Einstellungen können über Umgebungsvariablen angepasst werden:
Umgebungsvariable | Beschreibung | Standardwert |
| Kommagetrennte Glob-Muster zum Ermitteln von Diagrammdateien. |
|
| Kommagetrennte Glob-Muster, die bei der Dateisuche ignoriert werden. |
|
| Standarddiagrammtyp für die Konvertierung ( |
|
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 typecheckLizenz
Available Tools
3 toolsconvert_diagrams_readA
Batch scan and convert all workspace diagram files (.xml, .drawio) into Mermaid Markdown, returning their content directly as AI context.
Inputs: patterns, diagramType.
convert_diagrams_writeA
Batch scan workspace diagrams matching glob patterns and convert them to updated .md files on disk.
Inputs: patterns, diagramType.
list_diagramsA
Discover all Draw.io architecture diagram files (.xml, .drawio) in the workspace using glob patterns.
Inputs: ignore, patterns.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
list_diagrams is clearly discovery-only, while the two convert tools are separated by output behavior: _write persists .md files to disk and _read returns content as AI context. There is no meaningful overlap between any pair.
All tool names follow a consistent verb_noun pattern in lowercase snake_case, using the same 'diagrams' resource. The _read/_write suffixes are a coherent way to distinguish output modes, and list_diagrams fits the pattern as an independent discovery action.
Three tools is a well-scoped set for a focused converter utility: discover source files, convert to files, and convert to context. Each tool addresses a distinct workflow step without unnecessary expansion.
The core workflow of finding Draw.io diagrams and converting them to Mermaid Markdown is fully covered in both output modes (disk and context). No obvious dead ends or missing lifecycle operations are apparent for this narrow domain.
Related MCP Connectors
Draw architecture diagrams, UML, planning boards and clickable wireframes from your AI assistant.
Let Claude, Cursor, or ChatGPT author Mermaid diagrams your team can read and share.
Generate dynamic Mermaid diagrams and charts with AI assistance. Customize styles and export diagr…
Create and edit architecture diagrams from your AI agent; get an SVG and a live editable canvas.
Related MCP Servers
- AlicenseBqualityBmaintenanceEnables AI agents to programmatically create, modify, and analyze Draw.io diagrams through the Model Context Protocol. Supports generating architectural diagrams, flowcharts, and visualizations with bidirectional communication between AI systems and Draw.io.131,500MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to generate professional UML diagrams (class, use case, activity, sequence) from natural language descriptions, producing editable .drawio files compatible with diagrams.net.7109 npmISC
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to create, read, update, and delete Draw.io diagrams, allowing automated generation of architectural diagrams, flowcharts, and visual documentation.MIT
- AlicenseAqualityBmaintenanceEnables AI coding agents to list, read, create, update, delete, and render PlantUML and Mermaid diagrams, and check them against the actual codebase to detect architecture drift.15100 npm1MIT