Local Draw.io MCP

Ein lokaler STDIO-MCP-Dienst, der es Codex ermöglicht, bearbeitbare draw.io-XML-Dateien direkt zu erstellen und zu pflegen.

Werkzeuge

• server_info: Zeigt die Version und die erlaubten Verzeichnisse an.

• create_diagram: Erstellt .drawio anhand von Gruppen, Knoten und Verbindungen.

• inspect_diagram: Liest die Knoten, Verbindungen und Geometrieinformationen der ersten Seite aus.

• validate_diagram: Prüft auf doppelte IDs, ungültige Koordinaten, Grenzüberschreitungen, ungültige Verbindungen und überlappende Knoten.

• update_diagram: Fügt Knoten/Verbindungen hinzu oder ändert vorhandene Knoten.

Der Text in der Datei wird nur als Daten verarbeitet und nicht als MCP-Anweisungen ausgeführt.

Related MCP server: Draw.io MCP Server

Lokal ausführen

npm install
npm test
npm start

npm start verwendet STDIO. Nach einem normalen Start wartet der Dienst auf eine Verbindung eines MCP-Clients und zeigt keine interaktive Oberfläche an.

Anbindung an Codex

Öffnen Sie in der Codex-Desktop-App „Einstellungen → MCP servers → Add server“, wählen Sie STDIO und tragen Sie dann Folgendes ein:

• Command: C:\Program Files\nodejs\node.exe

• Arguments: absoluter Pfad der src\server.mjs dieses Projekts

• Working directory: das Verzeichnis dieses Projekts

Alternativ können Sie den Inhalt von config.example.toml nach ~/.codex/config.toml kopieren, die Pfade darin anpassen und Codex neu starten.

Im Codex-CLI können Sie Folgendes ausführen:

codex mcp list

Im Eingabefeld der Sitzung können Sie /mcp verwenden, um den Verbindungsstatus zu prüfen.

Pfad-Einschränkungen

Der Zugriffsbereich wird über die folgenden Umgebungsvariablen gesteuert; unter Windows werden mehrere Verzeichnisse durch Semikola getrennt:

• DRAWIO_MCP_READ_ROOTS

• DRAWIO_MCP_WRITE_ROOTS

Ist nichts konfiguriert, ist nur das Verzeichnis dieses MCP-Projekts zugänglich. Es wird empfohlen, nur den Projektbereich freizugeben und nicht die gesamte Festplatte als beschreibbar zu konfigurieren.

Beispiel-Aufruf

Nach der Verbindung können Sie Codex direkt sagen:

Verwenden Sie das drawio-MCP, um eine 主动预警系统.drawio zu erstellen, die eine Datenplattform-Ebene, eine Frühwarn-Engine-Ebene und eine Antwort-Feedback-Ebene enthält, und führen Sie nach Abschluss validate_diagram zur Prüfung aus.

Das Erstellungswerkzeug überschreibt standardmäßig keine vorhandenen Dateien; wenn eine Überschreibung notwendig ist, muss explizit overwrite=true übergeben werden.