aelm-mcp
v0.7.2
Published
MCP server + skills for the Aelm circuit-CAD toolchain. Lets an AI parse, render, analyze, and edit text-based electronic circuit diagrams.
Maintainers
Readme
Aelm MCP — Claude Code Plugin
MCP server for Aelm, a text-based electronic circuit CAD. Lets an AI parse, render, analyze, and edit circuit diagrams written in the Aelm DSL.
Prerequisites
This plugin registers the MCP server and installs its skills. It does not
install any binaries. Two executables must already be on your PATH:
| Binary | Purpose |
|---|---|
| aelm | The circuit-CAD CLI that does the real work. |
| aelm-mcp | The MCP server, which shells out to aelm. |
Both must be the same version.
aelm-mcpcalls CLI subcommands that may not exist in an olderaelm. A version mismatch surfaces as confusing tool errors, not a clean failure.
1. Install the Aelm CLI
Download the aelm binary for your platform from the
latest GitHub Release
and place it on your PATH. Verify with aelm --version.
2. Install the MCP server
cargo install --path . # from a clone of alphaelements/aelm-mcpVerify with aelm-mcp --version — it must match aelm --version.
Install the plugin
/plugin marketplace add alphaelements/aelm-mcp
/plugin install aelm-mcp@aelm-mcp-marketplaceThe plugin registers the aelm MCP server over stdio with no arguments, so
aelm-mcp resolves the aelm binary from your PATH and uses the current
directory for relative use imports. If you need --aelm-path,
--library-dir, or --working-dir, register the server manually instead —
see the repository README.
What's included
- MCP Server — 35 tools for parsing, validation, rendering (SVG/PNG), the part/symbol library, netlist and BOM extraction, geometry analysis, and dry-run circuit edits. Plus 6 resources and 7 prompts.
- Skill —
aelm-geometry-debug: teaches the agent to machine-check rendering and hit-test invariants with theanalyze_geometrytool instead of guessing from a rendered image.
Getting started
Ask the agent to work with a circuit:
> Render this .aelm file and check whether anything is off-gridThe agent calls render_svg to see it and analyze_geometry to get
structured Findings (grid alignment, label/wire interference, bbox
consistency, hit-test padding, DRC cross-reference).
