About zumen
zumen is an MCP server for creating diagrams from YAML through an AI agent. It proposes diffs for human review, preserving manual layout edits across regeneration.
Key features
- 01Diagram generation from YAML
- 02Human-applied proposed diffs
- 03Diagram inspection
- 04Export to SVG, PNG, Mermaid, and draw.io
- 05389 worked examples
- 06Link to open desktop window
Use cases
- 01Drafting floor plans or rail maps
- 02Refining a generated diagram layout
- 03Exporting diagrams to other formats
MCP support
Exposes tools for reading specifications and examples, proposing diffs, inspecting diagrams, and exporting them. It does not provide a tool that writes the source directly.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
15Saved tool list · updated 2w ago
This tool takes no parameters.
Details
From the project README@metataro/zumen-mcp
The MCP server for zumen — AI-editable diagrams as code. An AI agent (Claude Code and others) draws from one YAML file; a human fixes the layout; the fix survives the next regeneration.
claude mcp add zumen -- npx -y @metataro/zumen-mcp
Other MCP clients: run npx -y @metataro/zumen-mcp as a stdio server.
What the agent gets: zumen_spec (read this first), zumen_examples (389 worked examples — floor plans, lighting plots, pallet patterns, rail maps…), zumen_propose (a diff a human applies — there is no tool that writes the source directly), zumen_inspect, zumen_export (SVG / PNG / Mermaid / draw.io), and a live link to the open desktop window.
This package exists so that the library package @metataro/zumen stays at three dependencies: only people who want the MCP server install the MCP SDK.
MIT.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.