ShamanAndrey

Kicad AI Stack — AI skill for Claude Code

AI community

Workspace for designing boards with Claude Code and KiCad 10: one-command setup of kicad-mcp-layer and the working rules.

How to install Kicad AI Stack

This entry records only its repository, not the path inside it, so there is no exact command to give. Open ShamanAndrey/kicad-ai-stack and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Kicad AI Stack does

Workspace for designing boards with Claude Code and KiCad 10: one-command setup of kicad-mcp-layer and the working rules.

Alternatives in AI

Zen MCP Server — The power of Claude Code + Gemini / OpenAI / Grok / OpenRouter / Ollama / Custom Model working as one 11.3k ★
Konnect — AI-assisted PCB design for KiCAD 10. Native KiCAD plugin — a single Rust binary exposing 171 schematic, layout 341 ★
ClaudeR — Connect RStudio to Claude Code, Codex, Gemini, and other LLM agents via MCP 328 ★

README

kicad-ai-stack

A workspace for designing boards with Claude Code and KiCad 10: the library and MCP server, a one-command setup, and the working rules. Two repositories make it up:

kicad-mcp-layer, the library: an MCP server that drives KiCad 10 through kicad-cli, its IPC API and lossless file edits, and kicad_layer.design, a board as data with the KiCad files as build outputs. Install it alone if that is all you need.
kicad-ai-stack, this repository: the setup script that fetches and wires everything, and the rules a Claude Code session works by.

One folder per role:

kicad-mcp-layer/ the product: kicad_layer.design, a board as data with the KiCad files as build outputs, and the MCP server that checks, reads, renders, exports and edits KiCad projects. Its own README covers install, tools and configuration.
research/ is created on your machine by the tools and is not part of this repository: references/ is the document library doc_fetch fills with the datasheets and reference designs you need, parts/ holds the fact sheets doc_facts reads. Bring your own documents; none are redistributed.
tools/ where FreeRouting and its Java runtime go; tools/README.md says which.
projects/ the boards. They are private repositories and are not part of this one; the hello-world example that exercises the whole loop is kicad-mcp-layer/examples/hello_world.
CLAUDE.md the working rules Claude Code reads in this folder.

Setting it up

Install KiCad 10.0.6 from kicad.org, have Python 3.12 or newer and git on the PATH, then:

python bootstrap.py

It clones the library into `kicad-mcp-layer/` (its own repository), creates its virtual environment and installs it, writes `.mcp.json` with this machine's paths so Claude Code finds the server when opened in this folder, and runs the health check. Options: `--tools` fetches FreeRouting and, on Windows, a Java runtime