embedded-society/altium-designer-mcp

View on GitHub ↗

MCP server for AI-assisted management of Altium Designer component libraries

37 ★11 forksRustUpdated 18d ago

What you need to know

MCP server that gives AI assistants file I/O and primitive-placement tools for Altium Designer .PcbLib and .SchLib libraries, so an AI can create and maintain any footprint or symbol while this Rust tool handles the undocumented OLE binary format — the AI does the engineering, the tool writes the files.

Install

git clone the repo and run cargo build --release; binary lands at target/release/altium-designer-mcp
Config file at ~/.altium-designer-mcp/config.json on Linux/macOS

Usage

  • Configure allowed_paths in config.json to the directories the server may read/write; read-only tools are never rate limited.
  • Point the AI at datasheet and reasoning while the server's 34 tools handle read/write of footprints (PcbLib) and symbols (SchLib).
  • Verify downloaded releases with gh attestation verify and sha256sum --check before trusting binaries (they are not code-signed).
  • Attach STEP 3D models via the step_model attribute; embedded models travel with components, external references are removed on cross-library copies.

Key features

  • 34 tools for read/write, inspection + ASCII-art preview, diffing, in-place edits, component/library management, import/export, repair, and backups.
  • Full primitive coverage: pads (with pin-1 shapes), vias, tracks, arcs, regions, text, fill, and component bodies; 16 SchLib primitives incl. bezier and text frames.
  • Automatic timestamped backups before every destructive op (5 kept per file) plus dry_run previews.
  • STEP model integration with embedded vs external distinction and extract_step_model.
  • Long component names (>31 chars) are preserved transparently despite the OLE storage-name limit.

Best for

Embedded/EE teams using Altium Designer with an MCP-capable AI who want AI-generated and maintained component libraries without corrupting the binary files.

Caveats

  • Binaries are not code-signed — Windows SmartScreen and macOS Gatekeeper warn on first run (open via right-click).
  • GPL-3.0 licensed.
  • STEP models are attached, not generated; a dedicated mechanical MCP server for parametric 3D is still planned.
  • This server works offline on library files; driving a live Altium session is the complement project coffeenmusic/altium-mcp.
  • Some on-site tooling (PowerShell/DelphiScript sample regeneration) needs a real Altium installation.
Platforms: macOS · Linux · WindowsClients: Claude Code · Claude Desktop · Google Antigravity · VSCode Copilot

Reviewed 2026-08-18

Topics

ai-agentsaltiumaltium-designeraltium-libraryclaudeedaelectronic-design-automationelectronicsfootprintllmmcpmcp-servermodel-context-protocolpcbpcb-designpcblibrustschematicschlib
Stars
37★
Forks
11
Language
Rust
License
GPL-3.0
Created
2026-01-17
Last push
2026-08-17