fcp-drawio
The fcp-drawio server enables creating, editing, querying, and managing draw.io diagrams through high-level, intent-based commands — no manual XML, IDs, or geometry required.
Diagram Manipulation (drawio)
Add shapes of 12 types (svc, db, api, queue, cloud, actor, doc, box, decision, circle, process, triangle) with optional themes, positions, and sizes
Connect shapes with styled edges (solid, dashed, dotted, animated, thick, curved, orthogonal) and arrow types (directed, bidirectional, undirected)
Remove shapes or connections individually or via selectors (e.g.,
@type:db,@orphan,@all)Style shapes with fill/stroke/font colors, bold/italic, and predefined color themes (blue, green, red, orange, purple, yellow, gray, dark)
Move, resize, and swap shapes; auto-position relative to others using
near:/dir:heuristics with collision avoidanceAuto-layout using ELK algorithms (layered, force, tree) with configurable direction (TB/LR/BT/RL)
Group/ungroup shapes, manage pages and layers (add, switch, remove, show, hide)
Define reusable custom component types and load shape packs
Export diagrams as PNG, SVG, or PDF (inline or file)
Diagram Inspection (drawio_query)
Query current diagram state: list shapes, describe nodes, inspect connections, find elements by type/group/position/recency
Session Management (drawio_session)
Create new diagrams, open existing
.drawiofiles, save or save-asUndo/redo operations or revert to a named checkpoint
Help (drawio_help)
Retrieve the full command reference with all operations, options, and examples
Allows creating and editing draw.io diagrams through intent-level commands, enabling AI agents to build architecture diagrams, flowcharts, and system maps by describing high-level operations.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@fcp-drawio Draw a diagram: blue AuthService connects to green UserDB"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
fcp-drawio
MCP server for creating and editing draw.io diagrams through intent-level commands.
What It Does
fcp-drawio lets LLMs build architecture diagrams, flowcharts, and system maps by describing what they want -- not how to draw it. The LLM sends high-level operations like add svc AuthService theme:blue and connect AuthService -> UserDB, and fcp-drawio renders them into fully styled draw.io XML, positioning shapes with near:/dir: heuristics and collision avoidance by default -- or hands off to an ELK auto-layout pass on demand via the layout op. Built on the FCP framework.
Related MCP server: drawio-mcp
Quick Example
drawio([
'add svc AuthService theme:blue',
'add db UserDB theme:green near:AuthService dir:right',
'connect AuthService -> UserDB label:queries',
])Response:
+svc AuthService @(200,200 140x60) blue
+db UserDB @(400,200 120x80) green
~AuthService->UserDB "queries" solid
digest: 3s 1e 0gThis produces a draw.io diagram with a blue rounded-rectangle service node, a green database cylinder, and a labeled edge between them -- all positioned automatically.
Available MCP Tools
Tool | Purpose |
| Batch mutations -- add shapes, connect, style, group, layout |
| Inspect the diagram -- map, list, describe, connections, find |
| Lifecycle -- new, open, save, checkpoint, undo, redo |
| Full reference card |
Component Library
Type | Shape | Use For |
| Rounded rect | Services, components |
| Cylinder | Databases, storage |
| Hexagon | APIs, gateways |
| Parallelogram | Queues, streams |
| Cloud | External services |
| Person | Users, personas |
| Document | Files, reports |
| Rectangle | Generic |
| Diamond | Decisions, conditions |
| Ellipse | States, events |
| Double-bordered rect | Predefined processes |
| Triangle | Warnings, deltas |
Themes
Apply color themes to any shape: blue, green, red, orange, purple, yellow, gray, dark.
Installation
Requires Node >= 22.
npm install @ostk-ai/fcp-drawioMCP Client Configuration
{
"mcpServers": {
"drawio": {
"command": "node",
"args": ["node_modules/@ostk-ai/fcp-drawio/dist/index.js"]
}
}
}Architecture
4-layer architecture:
MCP Server (Intent Layer)
src/server/ -- Parses op strings, resolves refs, dispatches
|
Semantic Model (Domain Brain)
src/model/ -- In-memory entity graph, event sourcing
|
Layout
Default: near/dir positioning heuristics + collision-pushing
On demand: `layout` op runs elkjs (layered/force/tree, flow:TB/LR/BT/RL)
|
Serialization (XML)
src/serialization/ -- Semantic model <-> mxGraphModel XMLSupporting modules:
src/parser/-- Operation string parsersrc/lib/-- Component library, themes, stencils, draw.io CLI integration
See docs/examples/ for example diagrams (including the multiplayer game backend) and docs/ for design documents.
Development
npm install
npm run build # tsc
npm test # vitest, 498 tests
npm run test:watch
npm run dev # tsc --watchLicense
MIT
Available Tools
4 toolsdrawioA
Execute drawio operations. Each op string follows the FCP verb DSL.
SHAPES: add TYPE LABEL [theme:T] [near:REF dir:DIR] [at:X,Y] [size:WxH] [label:"Display Name"] remove REF | remove @SELECTOR define NAME base:TYPE [theme:T] [badge:"text"] [size:WxH]
CONNECTIONS: connect SRC ARROW TGT [label:"text"] [style:STYLE] [exit:FACE entry:FACE] disconnect SRC -> TGT
APPEARANCE: style REF [fill:#HEX] [stroke:#HEX] [font:#HEX] [fontSize:N] [bold] [italic] label REF "new text" | label SRC -> TGT "new text" badge REF "text" [pos:POSITION]
POSITION: move REF to:X,Y | to:REGION | near:REF dir:DIR resize REF to:WxH swap REF REF layout @all algo:layered|force|tree dir:TB|LR|BT|RL [spacing:N] orient TB|LR|BT|RL
ORGANIZATION: group REF REF ... as:"Group Name" ungroup "Group Name"
STRUCTURE: page add|switch|remove|list "Name" layer create|switch|show|hide|list "Name"
META: checkpoint NAME title "Diagram Title" load list | load PACK
VISUAL: export [inline|file] [fmt:png|svg|pdf] [width:N] [height:N] [page:N] [as:PATH]
NODE TYPES: box plain rectangle (generic) svc rounded rectangle (services, components) circle ellipse (states, events) decision diamond (decisions, conditions) db cylinder (databases, storage) api hexagon (apis, gateways) cloud cloud (external services) actor person shape (users, personas) doc document shape (files, reports) queue parallelogram (queues, streams) triangle triangle (warnings, deltas) process double-bordered rect (predefined processes)
THEMES (FILL / STROKE): blue #dae8fc / #6c8ebf green #d5e8d4 / #82b366 red #f8cecc / #b85450 yellow #fff2cc / #d6b656 orange #ffe6cc / #d79b00 purple #e1d5e7 / #9673a6 gray #f5f5f5 / #666666 dark #1a1a2e / #16213e (light text) white #ffffff / #000000
EDGE STYLES: solid, dashed (- - -), dotted (· · ·), animated, thick, curved, orthogonal Arrows: -> (directed), <-> (bidirectional), -- (undirected) Arrow heads: arrow, open-arrow, diamond, circle, crow-foot, none
SELECTORS: @type:TYPE, @group:NAME, @connected:REF, @recent, @recent:N, @all, @orphan, @page:NAME, @layer:NAME
RESPONSE PREFIXES:
shape created ~ edge created/modified
shape modified - shape/edge removed ! group operation @ layout/position change
CONVENTIONS:
Labels are unique identifiers - no ID management needed
Position auto-computed if omitted (near last created shape)
near:REF dir:DIRECTION places relative to existing shape
All XML structure, IDs, and geometry handled by the tool
Call drawio_help for full reference with examples
Inputs: ops (required).
drawio_helpA
Returns the drawio FCP reference card.
Inputs: no named parameters.
drawio_queryA
Query drawio state. Read-only.
Inputs: q (required).
drawio_sessionC
drawio lifecycle: new, open, save, checkpoint, undo, redo.
Inputs: action (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
The four tools have distinct purposes: drawio performs all diagram operations, drawio_help provides reference, drawio_query is read-only, and drawio_session manages lifecycle. However, the monolithic drawio tool bundles many actions into one, causing potential ambiguity for the agent when selecting the exact operation needed.
All tool names follow a consistent 'drawio_<suffix>' pattern (drawio, drawio_help, drawio_query, drawio_session), making it predictable and easy to navigate.
With only 4 tools for a complex diagramming domain, the count is too low. The main drawio tool alone encapsulates dozens of operations (shapes, connections, appearance, layout, etc.), which should ideally be split into multiple focused tools to avoid overloading the agent.
The monolithic drawio tool covers a broad range of operations: shapes, connections, styles, grouping, pages, layers, export, etc. Minor gaps might exist (e.g., importing), but the overall functionality is comprehensive for creating and editing diagrams.
Related MCP Connectors
MCP server for AI dialogue using various LLM models via AceDataCloud
MCP server for generating rough-draft project plans from natural-language prompts.
Collaborative whiteboard MCP server — create objects, connectors, C4 diagrams, and manage boards
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI assistants to programmatically create and manage flowcharts, ERDs, and swimlane diagrams. It provides tools for manipulating diagram structures, performing auto-layouts, and exporting to Mermaid or Markdown formats.MIT
- AlicenseAqualityDmaintenanceAn MCP server that enables LLMs to create and open diagrams in draw.io using XML, Mermaid, or CSV formats, by building a URL with compressed content and opening it in the browser.385 npmMIT
- AlicenseAqualityDmaintenanceMCP server for generating diagrams, charts, and visualizations using Gemini image generation on Vertex AI. Supports auto-detection of diagram types, multiple style modes, and iterative refinement.367 npm1MIT
- AlicenseBqualityCmaintenanceMCP server that enables AI assistants to create, parse, render, and validate Draw.io diagrams programmatically.1427 PyPI2MIT