Orrery — Claude Code MCP server: architecture diagrams from YAML
Turns one YAML spec into animated architecture and process diagrams, exported as SVG, PNG, editable draw.io, a React component or an HTML viewer.
claude mcp add orrery -- npx -y @sagargupta1610/orreryWhat Orrery does
You describe the system once in YAML and Orrery handles placement. The Eclipse Layout Kernel arranges nested boundaries, keeps edges at right angles and respects the node order you wrote unless that would cross lines. Icons come from the official vendor packs: AWS, Azure, Google Cloud, Kubernetes, GitHub Octicons and IBM Carbon, alongside tech logos and neutral symbols. Your own SVGs are allowed as local: icons, added and checked with orrery icons new and icons check.
The same spec can render as different figure types. The kind: field switches to a flowchart, a BPMN process with pools and lanes, a UML state machine, an org chart, a mind map or a customer journey map. Data models with keyed rows and crow's foot links, sequence diagrams and month- or quarter-based roadmaps are covered too. Writing the spec by hand is optional: orrery import builds one from Terraform, CloudFormation, CDK output, Docker Compose, Kubernetes manifests or Mermaid, and each node carries evidence: naming the file, line and identifier behind it. orrery verify fails once that evidence is gone.
Node.js 22 or newer is required. The CLI, layout engine, PNG renderer, fonts and cloud icon packs live inside the skill folder, but logo and glyph sets are fetched from their npm libraries the first time a diagram needs them, so that first render needs network access.
What it helps with
- draw a GitOps delivery diagram with official AWS and Kubernetes icons
- get an editable draw.io file from the same spec as the README SVG
- build a step-by-step sequence diagram of a call flow
- check a diagram against the code and catch nodes Terraform no longer has
- lay out a quarterly roadmap with milestones and dependencies
Example prompts for the agent
- Render
docs/hero.yamland give me both the SVG and the PNG - Import the Kubernetes manifests into a spec and show me what changed
- Turn this spec into a BPMN process with lanes
How to install Orrery
Platform CLI
claude mcp add orrery -- npx -y @sagargupta1610/orreryPlatform CLI
codex mcp add orrery -- npx -y @sagargupta1610/orreryConfig file
{
"mcpServers": {
"orrery": {
"command": "npx",
"args": [
"-y",
"@sagargupta1610/orrery"
]
}
}
}Config file
{
"servers": {
"orrery": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sagargupta1610/orrery"
]
}
}
}Platform CLI
gemini mcp add orrery npx -y @sagargupta1610/orreryStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Orrery
How do I install Orrery in Claude Code?
Run claude mcp add orrery -- npx -y @sagargupta1610/orrery.
What does Orrery do?
It reads a YAML spec and produces an animated architecture or business-process diagram, exported to SVG, PNG, draw.io, a React component, an HTML viewer or Mermaid text.
What does Orrery need to run?
Node.js 22 or newer. Logo and glyph sets load from npm the first time a diagram uses them, so that first render requires network access.
