Repository navigation
Releases
v2.0.0
Highlights
- 25 diagram types (was 2): sequence, swimlane, ER, state machine, timeline,
Gantt, quadrant, funnel, Venn, flywheel, and hand-drawn bar/line/scatter. - Exports now render through a Python port of roughjs, so SVG/PNG match the
Excalidraw canvas instead of being clean-geometry approximations. - New tools:
list_diagram_types,get_diagram_schema.
Compatibility
create_diagramparameter order changed (output_pathfirst). MCP clients
call by keyword and are unaffected; positional Python callers need updating.- Export output changed — SVG snapshot tests will show diffs.
knowledge graph Integration
The big one: your architecture is now a living knowledge graph, not just a diagram. This release turns the project from a diagram generator into a persistent, queryable model of your system — diagrams become
views of it.
🧠 Architecture Knowledge Graph
Your services and dependencies now live in a single version-controlled markdown file (default .claude/architecture.md) that the AI builds once and reuses everywhere. It's human-readable, round-trips losslessly,
and diffs cleanly in PRs.
- One source of truth, many views — render the full system, a single domain, or everything within N hops of one service
- Queryable — "what breaks if payments goes down?" returns the real upstream blast radius
- Self-checking — lint for dependency cycles, single points of failure, orphans, and dangling references
- Bootstrap from what you have — import existing
.excalidrawdiagrams into the graph - Export anywhere — Mermaid, Graphviz DOT, or JSON
- Git-aware — diff how the architecture changed since any ref; generate onboarding docs; detect drift against actual Python imports
🔀 Parallel edges
Two communication modes between the same services (e.g. a solid REST /charge call and a dashed Kafka payment.requested event) now render as two distinct, labelled arrows instead of collapsing into one.
🛠️ New MCP tools (kg_*)
kg_init · kg_add_service · kg_remove_service · kg_link · kg_unlink · kg_set_domain · kg_info · kg_render · kg_render_view · kg_render_around · kg_render_domain · kg_import ·
whats_connected_to · kg_path · kg_lint · kg_export · kg_diff · kg_onboarding_doc · kg_drift
🐛 Fixes
- Edge labels no longer overlap arrows in SVG/PNG export — the line is now masked behind bound labels, matching Excalidraw's native rendering (improves every exported diagram)
- Fixed an infinite loop in edge routing when two arrows share an endpoint
📚 Docs
- New README section for the knowledge graph, with a
kg_*tool reference - New
architecture-knowledge-graphskill that teaches the AI how to read a codebase and build a clean graph
✅ Compatibility
Fully additive — the existing tools (create_diagram, mermaid_to_excalidraw, modify_diagram, get_diagram_info, export_diagram) are unchanged. No breaking changes.
📦 Install / upgrade
pip install -U excalidraw-architect-mcp
# or, no install:
uvx excalidraw-architect-mcp
Full changelog: https://github.com/BV-Venky/excalidraw-architect-mcp/compare/v0.3.0...v1.0.3v0.3.0
feat: add export_diagram tool for SVG and PNG export by @nandanadileep
What's Changed
- feat: add export_diagram tool for SVG and PNG export (#13) by @nandanadileep in #14
New Contributors
- @nandanadileep made their first contribution in #14
Full Changelog: v0.2.3...v0.3.0
Python 3.10 Compatibility fix
Users on Python 3.10 were facing issues wrt Annotations as it is not Compatible. This version fixes the compatibility issues
MCP Registration
Updated ReadME instructions
Updated ReadMe and remove testpypi dependencies