excalidraw-architect-mcp
Excalidraw Architect MCP
Es ist ein ständiger Kampf, unbekannte und komplexe Codebasen zu verstehen – man muss die kognitive Überlastung bewältigen und sich vorstellen, wie alles zusammenpasst.
Das Problem
Wenn Sie sich in eine Codebasis einarbeiten, ein neues System entwerfen oder eine bestehende Architektur dokumentieren, vermittelt ein visuelles Diagramm in Sekunden, was seitenlanger Text nicht kann. Aber die heutigen Optionen sind nicht besonders gut. Mermaid-Diagramme sind schnell erstellt, haben aber begrenzte Möglichkeiten – man kann einen Knoten nicht ziehen, um ihn neu zu positionieren, oder Komponenten visuell gruppieren. Excalidraw löst diese Probleme, aber wenn LLMs versuchen, Excalidraw direkt zu generieren, halluzinieren sie Koordinaten – Boxen überlappen sich, Pfeile verheddern sich, und am Ende korrigieren Sie das Diagramm manuell.
Related MCP server: mermaid-to-excalidraw-mcp
Die Lösung
excalidraw-architect-mcp trennt das Was vom Wo – die KI konzentriert sich auf die Struktur, die Engine kümmert sich um die Pixel-Mathematik.
Ihr LLM beschreibt die Komponenten und Verbindungen, und das MCP übernimmt Layout, Styling und Rendering mithilfe eines geeigneten Graphen-Layout-Algorithmus. Über 50 Technologien (Kafka, PostgreSQL, Redis usw.) werden automatisch gestylt, Sie können Diagramme iterativ mit natürlicher Sprache bearbeiten („füge einen Cache vor der DB hinzu“), und es läuft vollständig offline in Cursor/Windsurf – keine API-Schlüssel erforderlich.
Perfekte Layouts bei jedem Mal – Sugiyama-Algorithmus mit adaptivem Abstand; keine überlappenden Boxen
Architekturbewusstes Styling – sagen Sie „Kafka“ und erhalten Sie einen Stream-gestylten Knoten, kein generisches Rechteck
Sprechen Sie mit Ihren Diagrammen – fügen Sie Komponenten zu einem bestehenden Diagramm hinzu, entfernen oder verkabeln Sie sie neu mit natürlicher Sprache
Hub-Knoten-Visualisierung – Gateways und Load Balancer dehnen sich automatisch aus, um ihre verbundenen Dienste zu umspannen
Export als SVG & PNG – konvertieren Sie jede
.excalidraw-Datei in ein portables Bild, kein Browser erforderlich
Sehen Sie es in Aktion
Jeder Frame unten wurde vollständig von der KI unter Verwendung dieses MCP generiert – null manuelle Positionierung.
E-Commerce-Plattform-Architektur

Zahlungsabwicklungsfluss

Anwendungsfälle
Einarbeitung in eine neue Codebasis – zeigen Sie auf einen Microservice und erhalten Sie ein High-Level-Architekturdiagramm, ohne eine einzige Zeile Code zu lesen. Zeigen Sie auf eine Reihe von Klassen für ein Low-Level-Flussdiagramm, wenn Sie Details benötigen.
Brainstorming und Systemdesign – wenn Sie ein neues System auf einem Whiteboard entwerfen oder über Kompromisse diskutieren, bitten Sie die KI, die Architektur währenddessen zu visualisieren. Iterieren Sie, indem Sie „füge hier einen Cache hinzu“ oder „tausche Kafka gegen SQS“ sagen, anstatt alles von Grund auf neu zu zeichnen.
Dokumentation, die aktuell bleibt – legen Sie die
.excalidraw-Datei in Ihr Repo und aktualisieren Sie sie mit natürlicher Sprache, während sich das System weiterentwickelt. Keine veralteten Diagramme von vor sechs Sprints mehr.
Schnellstart
Installation
pip install excalidraw-architect-mcpFür PNG-Export-Unterstützung (SVG funktioniert sofort):
pip install excalidraw-architect-mcp[png]Oder führen Sie es ohne Installation aus (erfordert uv):
uvx excalidraw-architect-mcpMCP in Ihrer IDE konfigurieren
Cursor – Fügen Sie dies zu .cursor/mcp.json hinzu:
{
"mcpServers": {
"excalidraw-architect": {
"command": "excalidraw-architect-mcp",
"transport": "stdio"
}
}
}Claude Code – Führen Sie diesen Einzeiler aus:
claude mcp add-json excalidraw-architect '{"type":"stdio","command":"excalidraw-architect-mcp"}' --scope userOder fügen Sie es manuell zu .mcp.json in Ihrem Projektstammverzeichnis hinzu:
{
"mcpServers": {
"excalidraw-architect": {
"type": "stdio",
"command": "excalidraw-architect-mcp"
}
}
}Windsurf / Andere IDEs – Gleiches Muster; verweisen Sie auf den excalidraw-architect-mcp-Befehl über stdio.
Installieren Sie die Diagramm-Design-Fähigkeit (empfohlen)
Dieses Repo enthält eine Diagram Design Skill, die der KI beibringt, wie Diagramme für beste Ergebnisse strukturiert werden – Knotenanzahl-Limits, Topologieregeln, Richtlinien für Kantenbeschriftungen und gängige Muster.
Für Cursor-Benutzer:
mkdir -p ~/.cursor/skills/excalidraw-diagram-design && \
curl -o ~/.cursor/skills/excalidraw-diagram-design/SKILL.md \
https://raw.githubusercontent.com/BV-Venky/excalidraw-architect-mcp/main/.skills/excalidraw-diagram-design/SKILL.mdFür andere IDEs: Laden Sie die SKILL.md-Datei herunter und fügen Sie sie zum Prompt-Kontext oder den Systemanweisungen Ihrer IDE hinzu.
Die KI wird die Fähigkeit automatisch aufgreifen und bei der Generierung von Diagrammen anwenden. Fühlen Sie sich frei, die Regeln an Ihre Vorlieben anzupassen – passen Sie Knoten-Limits an, fügen Sie Ihre eigenen Muster hinzu oder passen Sie die Styling-Richtlinien an.
Ein Hinweis zur Diagrammkomplexität: Mit zunehmender Anzahl von Komponenten und Verbindungen werden Diagramme zwangsläufig schwerer zu lesen – das gilt auch für von Menschen handgezeichnete Diagramme, nicht nur für automatisiertes Layout. Für beste Ergebnisse zielen Sie auf 6-15 Knoten in Architekturdiagrammen und 10-25 Knoten in detaillierten Abläufen ab. Wenn Ihr System größer ist, teilen Sie es in mehrere fokussierte Diagramme auf, anstatt alles in eines zu quetschen.
Verwendung
Fragen Sie einfach Ihre KI-IDE ganz natürlich:
"Erstelle ein High-Level-Architekturdiagramm dieser Codebasis"
"Erstelle ein Architekturdiagramm für ein Microservices-System mit einem API-Gateway, Auth-Service, User-Service, Order-Service, PostgreSQL, Redis-Cache und Kafka-Event-Bus"
"Konvertiere dieses Mermaid-Diagramm in ein Excalidraw-Diagramm"
"Füge eine Caching-Ebene zum Order-Service im High-Level-Architekturdiagramm hinzu"
"Exportiere das Architekturdiagramm als SVG"
"Exportiere das Diagramm als PNG mit 3-facher Auflösung"
Die KI ruft das MCP-Tool mit der Beziehungslandkarte auf. Das MCP kümmert sich um Layout, Styling und Ausgabe. Öffnen Sie die resultierende .excalidraw-Datei mit der Excalidraw VS Code-Erweiterung oder ziehen Sie sie in excalidraw.com.
Funktionen
Auto-Layout-Engine
Verwendet den hierarchischen Sugiyama-Layout-Algorithmus mit:
Adaptive Ebenenabstände – der Abstand passt sich an die Länge der Kantenbeschriftung an
Hub-Knoten-Dehnung – Gateways/Load Balancer dehnen sich aus, um verbundene Dienste zu umspannen
Hindernisbewusstes Kanten-Routing – Pfeile krümmen sich um Zwischenknoten, anstatt sie zu durchschneiden
Stapelung getrennter Komponenten – separate Teilgraphen (z. B. Monitoring-Stack) werden ohne Überlappung platziert
Komponentenbibliothek
Über 50 Technologie-Mappings mit automatischem visuellem Styling:
Kategorie | Technologien |
Datenbank | PostgreSQL, MySQL, MongoDB, DynamoDB, Cassandra, ClickHouse, SQLite, CockroachDB |
Message Queue | Kafka, RabbitMQ, SQS, Redis Streams, NATS |
Cache | Redis, Memcached, Varnish |
Load Balancer | Nginx, HAProxy, ALB/ELB, Traefik, Envoy |
Compute | Docker, Kubernetes, Lambda, ECS, Fargate |
Storage | S3, GCS, Azure Blob, MinIO |
API | REST, GraphQL, gRPC, WebSocket |
CDN | CloudFront, Cloudflare |
Monitoring | Prometheus, Grafana, Datadog, ELK |
Client | Browser, Mobile, Desktop, CLI |
Zustandsorientierte Bearbeitung
Diagramm-Metadaten sind in der .excalidraw-Datei eingebettet. Fragen Sie die KI:
"Füge einen Redis-Cache vor der Datenbank im bestehenden Diagramm hinzu"
Das MCP liest den aktuellen Zustand, wendet die Änderung an und rendert es mit dem richtigen Layout neu.
Mermaid-Konvertierung
Sie haben bereits ein Mermaid-Flussdiagramm? Konvertieren Sie es:
"Konvertiere dieses Mermaid-Diagramm in Excalidraw" (fügen Sie Ihre Mermaid-Syntax ein)
Bildexport
Exportieren Sie jedes .excalidraw-Diagramm in ein portables Bild – kein Browser, keine Excalidraw-App oder Node.js erforderlich.
SVG – null zusätzliche Abhängigkeiten; verwendet einen reinen Python-Renderer, der Rechtecke, Ellipsen, Rauten, Text (einschließlich mehrzeiligem Text) und Pfeile mit Pfeilspitzen verarbeitet
PNG – erfordert das optionale
cairosvg-Paket (pip install excalidraw-architect-mcp[png]); unterstützt einen konfigurierbaren Auflösungsmultiplikator (Standard 2×)
"Exportiere das Architekturdiagramm als SVG"
MCP-Tools
Tool | Beschreibung |
| Erstelle ein neues Diagramm aus strukturierten Knoten-/Verbindungsdaten |
| Konvertiere Mermaid-Flussdiagramm-Syntax in |
| Füge Knoten und Verbindungen zu einem bestehenden Diagramm hinzu, entferne oder aktualisiere sie |
| Lese den aktuellen Diagrammzustand (vor dem Ändern aufrufen) |
| Exportiere |
Mitwirken
Siehe CONTRIBUTING.md für Details.
Lizenz
MIT – siehe LICENSE.
Available Tools
26 toolscreate_diagramA
Create a new Excalidraw diagram of any supported type.
Two input modes:
Graph types (
architecture,flowchart) - passnodesandconnections. The tool handles layout, styling, and rendering; no coordinates needed.Typed diagrams (every other type) - pass
diagram_typeand aspecobject shaped for that type. Calllist_diagram_typesto choose a type andget_diagram_schemato see its spec shape.
Inputs: output_path (required), spec, nodes, theme, +3 more. Returns: result
export_diagramA
Export an .excalidraw file to SVG or PNG image.
Converts an existing .excalidraw diagram into a portable image file without requiring a browser or the Excalidraw application.
Inputs: input_path (required), output_path (required), scale, format. Returns: result
get_diagram_infoA
Get a structured summary of an existing Excalidraw diagram.
Call this BEFORE modify_diagram to understand what nodes and connections currently exist. The summary includes node ids, labels, component types, and the full connection topology.
Inputs: file_path (required). Returns: result
get_diagram_schemaA
Get the JSON schema and selection guidance for one diagram type.
Call this before passing a spec to create_diagram for a type you have
not used yet, so the payload matches on the first attempt.
Inputs: diagram_type (required). Returns: result
kg_add_serviceB
Add or update a service in the knowledge graph.
Inputs: id (required), tags, label, links, +6 more. Returns: result
kg_diffB
Show how the architecture changed since a git ref (default HEAD).
Compares the current knowledge file against its version at ref.
Inputs: ref, graph_path. Returns: result
kg_driftA
Detect drift between the declared architecture and Python imports under code_root.
Best-effort: treats each top-level package as a service and infers edges from imports. Reports undocumented and possibly-stale dependencies.
Inputs: code_root (required), graph_path. Returns: result
kg_exportC
Export the knowledge graph to another format.
Inputs: format, graph_path, output_path. Returns: result
kg_importB
Import an existing .excalidraw diagram's services into the knowledge graph.
Bootstraps the graph from diagrams you already created with this tool.
Inputs: excalidraw_path (required), graph_path. Returns: result
kg_infoA
Summarize the whole knowledge graph: services, domains, and topology.
Call this before mutating the graph to reason about current state.
Inputs: graph_path. Returns: result
kg_initB
Create a new architecture knowledge graph file (markdown).
The knowledge graph is the persistent source of truth for your system's services and dependencies. Diagrams are rendered from it.
Inputs: title, direction, overwrite, graph_path. Returns: result
kg_linkA
Add a directed dependency: from_id depends on / calls to_id.
Both services must already exist (add them with kg_add_service first).
style is one of solid/dashed/dotted/thick.
Inputs: to_id (required), from_id (required), label, style, +1 more. Returns: result
kg_lintA
Architecture health check: cycles, single points of failure, orphans, dangling references, and (optionally) unowned services.
Inputs: graph_path, check_owners. Returns: result
kg_onboarding_docC
Generate a human onboarding guide (entry points, hubs, domains) from the graph.
Inputs: graph_path, output_path. Returns: result
kg_pathC
Trace the shortest dependency path between two services.
Inputs: to_id (required), from_id (required), graph_path. Returns: result
kg_remove_serviceC
Remove a service and all dependencies touching it.
Inputs: id (required), graph_path. Returns: result
kg_renderC
Render the entire architecture to an .excalidraw file.
Inputs: output_path (required), theme, graph_path. Returns: result
kg_render_aroundB
Render a service plus everything within depth hops of it.
direction: "downstream" (its dependencies), "upstream" (its
dependents), or "both".
Inputs: depth (required), service_id (required), output_path (required), theme, +2 more. Returns: result
kg_render_domainC
Render only the services belonging to one domain.
Inputs: domain (required), output_path (required), theme, graph_path. Returns: result
kg_render_viewC
Render a focused diagram of just the given services (induced subgraph).
Inputs: node_ids (required), output_path (required), theme, graph_path. Returns: result
kg_set_domainC
Assign a service to a domain (optionally set the domain's display label).
Inputs: domain (required), service_id (required), label, graph_path. Returns: result
kg_unlinkC
Remove the dependency from_id -> to_id.
Inputs: to_id (required), from_id (required), graph_path. Returns: result
list_diagram_typesA
List every supported diagram type with guidance on when to use it.
Call this BEFORE create_diagram when the right diagram type isn't obvious. Picking the wrong type is the most common way a diagram fails - a swimlane drawn as a flowchart loses the handoffs that were the point.
Two rules worth applying whatever you pick:
Target density ~4/10. Above 9 nodes it is probably two diagrams.
Mark only 1-2 elements "focal": true. The accent color is a signal, and using it everywhere destroys it.
Returns: A table of type -> family, when to use it, and when not to.
Inputs: no named parameters. Returns: result
mermaid_to_excalidrawA
Convert Mermaid flowchart syntax into an Excalidraw diagram.
Supports the mermaid flowchart subset that AI agents commonly generate:
Directions: graph TD, LR, BT, RL
Node shapes: [text], {text}, ((text)), ([text])
Edge types: -->, ---, -.-> ==> with |label|
Subgraphs: subgraph Title ... end
Component types are auto-detected from node labels (e.g., a node labeled "PostgreSQL DB" automatically gets database styling).
Inputs: output_path (required), mermaid_syntax (required), theme. Returns: result
modify_diagramA
Modify an existing Excalidraw diagram created by this tool.
Supports iterative editing: add components, remove nodes, update labels, and rewire connections - without recreating the entire diagram.
IMPORTANT: Call get_diagram_info first to understand the current diagram state before making modifications.
For typed diagrams (sequence, pyramid, bar, swimlane, ...) there is a single operation:
{"op": "update_spec", "patch": {"tiers": [...], "title": "New title"}}The patch is deep-merged into the stored spec and the diagram re-rendered. Lists are replaced wholesale, so send the complete list to change one entry. The node/connection operations below apply to architecture and flowchart diagrams only.
Inputs: file_path (required), operations (required), theme. Returns: result
whats_connected_toA
Impact analysis: what breaks if service_id fails?
Reports direct dependents, the full transitive upstream blast radius, and what the service itself depends on.
Inputs: service_id (required), graph_path. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 26 tools
Most tools target clearly distinct operations, and descriptions separate KG management, diagram creation, and analysis queries well. The four kg_render* variants (full, domain, view, around) are close enough to cause some misselection risk, though each has a well-defined scope.
The kg_ prefix provides a strong, predictable pattern for graph operations, and most diagram tools use clear verb_noun names. Minor exceptions like whats_connected_to and mermaid_to_excalidraw break the pattern, but overall the naming is disciplined and readable.
At 26 tools, the server sits just above the heavy band, and the kg_render_domain/view/around trio could plausibly be consolidated into one parameterized render operation. The breadth is partly justified by spanning diagram authoring and knowledge-graph management, but the surface is still large.
The toolset covers the full lifecycle for both the knowledge graph and diagrams: init, add/update/remove, link/unlink, query, render, export, plus analysis features like lint, drift, diff, impact, and path tracing. The only missing operations are non-essential file-management tasks like deleting a rendered diagram.
Maintenance
Related MCP Connectors
Collaborative whiteboard MCP server — create objects, connectors, C4 diagrams, and manage boards
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
Create and edit architecture diagrams from your AI agent; get an SVG and a live editable canvas.
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Related MCP Servers
- AlicenseAqualityCmaintenanceAn MCP server for Excalidraw diagram creation and headless rendering, enabling interactive canvas editing and automated SVG/PNG export via Playwright.41MIT
- AlicenseAqualityDmaintenanceMCP server that converts Mermaid diagrams to styled Excalidraw files, saving them directly to disk without token overhead.2MIT
- FlicenseAqualityBmaintenanceAn MCP server that generates standalone SVG architecture diagrams from text descriptions, running entirely on your machine with no dependencies or network access.8-
- AlicenseAqualityDmaintenanceMCP server for generating and editing architecture diagrams from natural language or code, supporting formats like Terraform, docker-compose, Kubernetes, SQL, Mermaid, and PlantUML.2MIT