archdiagram
Turn an architecture description into an editable diagram whose nodes are the official vendor service icons (Azure App Service, AKS, Key Vault, S3, GKE, ...) - not a flowchart of labelled boxes.
接入你的智能体
从发布者处安装。不是 PlugMCP 端点。
远程 URL 还是本机命令? 两种安装方式的区别
来自发布者
Turn an architecture description into an editable diagram whose nodes are the official vendor service icons (Azure App Service, AKS, Key Vault, S3, GKE, ...) - not a flowchart of labelled boxes.
Turn an architecture spec into editable diagrams with official vendor service icons (Azure/AWS/GCP/K8s) - .pdf/.drawio/.vsdx. Usable by AI agents via skill or MCP server.
A coding agent (Cursor, Claude Code, Codex) translates a natural-language architecture into a small JSON spec; the deterministic Python core renders that spec to:
Lucid note: Lucid does not map draw.io's named vendor stencils or its
img/lib/...icon references, so those render blank on import..drawio/.vsdxtherefore embed icons (--drawio-mode portable) to maximise render success, and the PDF is the reliable icons-always-render deliverable for Lucid.
Rendered from the specs in examples/ - same engine, real vendor icons.
jsonschema). .vsdx is written with zipfile + xml.unittest.mcp SDK - only inside mcp_server/.@resvg/resvg-js - rasterise icons to PNG; used by .vsdx (embedded glyphs) and .pdf.
If absent, .vsdx falls back to labelled boxes and .pdf errors with an install hint.pdfkit + svg-to-pdfkit - SVG -> PDF for .pdf.tools/download_icons.py.# 1. (optional) fetch vendor icons into the local cache
python -m tools.download_icons --vendors azure,aws,gcp,kubernetes
# 2. (optional) install the Node rasterise/pdf bridge
cd node && npm install && cd ..
# 3. render a spec
python -m archdiagram.cli render examples/sample_spec.json --format pdf -o out/arch.pdf
python -m archdiagram.cli render examples/sample_spec.json --format drawio -o out/arch.drawio --drawio-mode portable
python -m archdiagram.cli render examples/sample_spec.json --format vsdx -o out/arch.vsdx
{
"title": "Web platform",
"direction": "LR",
"groups": [{ "id": "app", "label": "Application tier", "vendor": "azure" }],
"nodes": [
{ "id": "web", "service": "azure.app_service", "label": "Web App", "group": "app" },
{ "id": "aks", "service": "azure.aks", "label": "AKS", "group": "app" },
{ "id": "kv", "service": "azure.key_vault", "label": "Key Vault" }
],
"edges": [
{ "source": "web", "target": "aks", "label": "http" },
{ "source": "aks", "target": "kv" }
]
}
service is "<vendor>.<service_key>". Unknown services degrade gracefully to a labelled box.
Node positions are computed by a deterministic, hand-rolled layered layout (no graphviz). Provide
explicit x/y on a node to override the computed position.
This repo is built to be driven by agentic AI tools (Cursor, Claude Code/Desktop, Codex, ...) straight from Git. Pick either path:
Clone the repo and point your agent at skill/SKILL.md. It
teaches the agent the spec schema, catalog lookup, and render commands so it can
go from a natural-language architecture to rendered files. See also
AGENTS.md.
git clone https://github.com/bharathgnana/archdiagram.git
cd archdiagram && python -m tools.download_icons
pip install "archdiagram[mcp]"
python -m mcp_server.server # stdio transport
Exposes validate_spec, render_diagram, search_catalog, and list_catalog
tools. A sample client config is in examples/mcp.json
(drop it into .cursor/mcp.json or claude_desktop_config.json).
archdiagram/ pure-Python core (spec, layout, catalog, emitters)
mcp_server/ optional MCP server (only place the `mcp` SDK is used)
node/ optional Node bridge (resvg rasterise + svg->pdf)
tools/ icon downloader + icon source map
skill/ SKILL.md for agentic AI tools
examples/ sample specs + mcp.json
tests/ stdlib unittest suite
python -m unittest discover -s tests
Anyone can clone, install (pip install -e .), and use it. To propose changes,
fork and open a pull request - see CONTRIBUTING.md for the
dev setup and workflow.
Turn an architecture spec into editable diagrams with official vendor service icons (Azure/AWS/GCP/K8s) - .pdf/.drawio/.vsdx. Usable by AI agents via skill or MCP server.
工具
暂无工具列表。远程服务器在首次健康检查后会获得工具列表。
常见问题
在本页复制适用于 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 配置。它使用发布者的安装方式,而不是 PlugMCP 代理。
此记录未列出必需的环境变量。
Archdiagram 通过 stdio 在本地运行。
上次检查时间:2026-10-28。 Turn an architecture spec into editable diagrams with official vendor service icons (Azure/AWS/GCP/K8s) - .pdf/.drawio/.vsdx. Usable by AI agents via skill or MCP server.