io.github.meta-taro/zumen

Official

by meta-taro · HTML

AI-editable diagrams as code: draw from YAML, propose diffs a human applies, export SVG/Mermaid.

io.github.meta-taro/zumen MCP Server

The io.github.meta-taro/zumen server provides an “AI-editable diagrams as code” workflow. It operates on diagrams defined from YAML, can propose diffs that a human applies, and supports exporting diagrams to SVG and Mermaid.

🛠️ Key Features

Diagrams as code
Draw from YAML
Propose diffs for human application
Export to SVG and Mermaid

🚀 Use Cases

Editing diagram definitions using YAML
Reviewing AI-suggested diagram changes via diffs
Generating diagram outputs for documentation or tooling (SVG, Mermaid)

⚡ Developer Benefits

Source diagrams in YAML form
Apply proposed changes as diffs
Export diagrams in common formats (SVG, Mermaid)

⚠️ Limitations

No tool count or additional capabilities were provided in the available server data.

Topics

ai-agentsarchitecture-diagramclaude-codediagram-as-codediagramsmcpmcp-serversvgtauriyaml

packages/zumen-mcp/README.md1 KBView on GitHub

@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.

bash

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.

Install

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "zumen": {
      "command": "npx",
      "args": [
        "-y",
        "@metataro/zumen-mcp@0.6.1"
      ]
    }
  }
}