design-doc-generator-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Design Doc Generator
One command in Claude Code. A polished design doc — Markdown and HTML, both saved straight into your repo.
❌ Without it
Real work gets done. The design doc doesn't — it gets skipped, or rushed into a note nobody reads.
Diagrams get left out because drawing them takes longer than the fix did.
Three months later, nobody remembers why it was built that way. Not even you.
✅ With it
Run
/design-doc. Claude turns the session you just had into a structured, professional doc.Two diagrams, generated and styled automatically. Nobody drags a single box.
The reasoning gets captured while it's fresh — not reconstructed from memory later.
What you get
Output | Where |
Markdown file |
|
Interactive HTML | Same folder, |
Both are always saved, every time — nothing to opt into.
Every doc includes:
Abstract, problem statement, architecture and flow diagrams, key decisions and trade-offs, risks — irrelevant sections are dropped, never padded
At least two Mermaid diagrams wherever the session supports them: a static architecture view and a runtime sequence view, sized and styled automatically
An auto-inserted table of contents
Two more doc shapes, detected automatically: a root-cause/bug-investigation report, and a comparison doc for "which approach" decisions
Related MCP server: adr-skills
How it works
Install
npx design-doc-generator-mcp initRun once, inside the project you want to document — registers the MCP server and installs the /design-doc
skill. Restart Claude Code, do real work, then run:
/design-docUsage
Flag | What it does |
(none) | Drafts the default design doc for whatever was just discussed |
| Activates a Pro license key |
| Shows usage help |
Running it again on the same topic updates the same files — it never creates a duplicate.
Your code never leaves your machine
This tool never reads your source files. It never calls an LLM itself. It only reads lightweight git metadata —
branch, git status, a git diff --stat summary, your last 15 commit messages. Claude drafts the document
inside your own session, on your own account.
Two things ever reach a network: the section template request when drafting (a mode string, plus your license
key if you've activated one), and your license key itself when you run --activate. Pro status is always
verified against that key server-side, never assumed from anything the client claims.
Free vs. Pro
Free | Pro | |
Design docs | 5 / day | Unlimited |
Content depth | Full | Full |
HTML export | Included | Included |
Signup required | No | No |
Pro removes the daily cap. That's the only difference.
License
Elastic License 2.0 — free to install and use for drafting your own design docs. You may not resell it as a hosted service, or bypass its license-key checks.
This server cannot be deployed
Maintenance
Related MCP Connectors
Turn calls and notes into process flow diagrams in Claude, ChatGPT, VS Code, Cursor, and Teams.
Bring meeting decisions, tasks and user stories into your AI editor (Claude, Cursor, Copilot).
Persistent memory for Claude Code and Cursor. Stop re-explaining your project every session.
Run your docs site from Claude. Write for free. Pay when you publish.
Related MCP Servers
- AlicenseBqualityBmaintenanceAutomatically collects, summarizes, and documents code from vibe coding sessions, generating multiple document types (README, DESIGN, TUTORIAL, etc.) and publishing them to platforms like Notion, GitHub Wiki, and Obsidian.1574 npm1MIT
- AlicenseAqualityCmaintenanceAutomatically generates Architecture Decision Records (ADRs) from Claude Code conversations using Claude Opus. Features AI quality review, duplicate detection, and dependency graph.912 npm3MIT
- AlicenseNot gradedqualityDmaintenanceAutomatically captures technical and product decisions from Claude Mac app sessions and writes them into project files, enabling seamless context transfer between strategy and coding sessions.5 npm1ISC
- AlicenseNot gradedqualityAmaintenancePersists Claude Code sessions to Notion as team memory, enabling queryable recall of decisions, work state, and project architecture.MIT