Die Super-Features (Auszug)

Jeder Button dispatcht einen kanonischen, geführten Auftrag — mit der aktuellen Editor-Auswahl als Wirkbereich (nichts markiert = ganzes Board). Vollständige Liste + v1-Grenzen: docs/superfeatures.md.

Dazu: Bus-Radar, Board erklären, Netz-Navigator, Pin-Tausch (Vorschläge), Ausrichten & Anordnen, Polar-Board, Skizzen-Layer/-Dirigent, Thermik, Betriebstemperatur, Slew-Rate, Impedanz, DFM-Check, Kosten-Schätzer, SPICE-Modelle, Bauteil-Sourcing, Foto→Schaltung, Sicherheitsabstände, Firmware-Pinmap, MLCC-Derating, Silk-Aufräumen, Datenblatt→Schaltung.

▶ Demo — 10 Referenz-Bausätze

Der ▶ Demo ▾-Knopf im Chat-Panel öffnet ein Menü mit 10 kuratierten Bausätzen. Jeder fährt den vollen Ablauf Idee → Schaltplan → Berechnung → Platine ab und lässt anschließend die zum Bausatz passende Super-Feature-Pipeline laufen (z. B. Bus-Radar → semantischer ERC → Impedanz). So sieht man in einem Klick, was der Copilot produziert — ohne eigenes Board. Daneben liegt eine 🔧 Schnell-Demo (Testboard) für den 10-Sekunden-Blick.

Reife-Label je Bausatz — zwei unabhängige Achsen, ein Symbol (demo_kits.stage, ein grüner Test, keine Meinung):

• ⭐ Prime-Time — beide Achsen grün: Schaltplan Pin-für-Pin datenblatt-geprüft und Platine 0 DRC / 0 offene Netze.
• ✅ Verified — eine Achse grün (die andere bewusst oder noch offen).
• 🔬 In Arbeit — noch keine Achse grün.

Stand: 8 ⭐ / 2 ✅ / 0 🔬 — alle 10 Platinen bauen DRC-sauber (0 Fehler, 0 offene Netze); Datenblatt-Belege je Bausatz in docs/kit_datasheet_reviews.md.

Die 10 Spec-JSONs liegen unter kicad_mcp/resources/data/demo_kits/; drei (Buck, Motor, Audio) sind seit 0.27.0 Build-Artefakte aus Circuit-Block + Rezept (eine Quelle, tests/test_kit_compose.py wacht). Der ganze Fahrplan, wie aus den Startplatzierungen 0/0-Platinen wurden: docs/roadmap.md.

Install

A) Das KiCad-Plugin (empfohlen — Chat + alles oben)

1. Hole claude_kicad-<version>-pcm.zip:
   • Download aus dem neuesten GitHub Release, oder
   • selbst bauen: python make_pcm_zip.py → dist/claude_kicad-<version>-pcm.zip (pure stdlib, kein KiCad nötig). Alternativ: install_plugin.bat / install_plugin.sh installieren direkt aus dem Repo-Checkout.
2. KiCad: Plugin- und Content-Manager → Aus Datei installieren… → Zip wählen. (Nicht das GitHub-Auto-Zip nehmen — PCM lehnt den <repo>-<branch>/-Wrapper ab.)
3. KiCad neu starten → neuer Toolbar-Button im PCB-Editor. Der erste Klick öffnet die Einrichtungs-Checkliste: installiert die Python-Abhängigkeiten in einen plugin-eigenen _deps-Ordner, aktiviert KiCads IPC-API und hilft beim Claude-Code-Login. Danach: Board öffnen, Button klicken, chatten.

Voraussetzungen: KiCad 10.0, Claude Code CLI (Login per Subscription, kein API-Key). Updates liefert der eingebaute Self-Updater (Versionsanzeige im Panel-Titel; Historie: plugin/VERSIONS.md).

B) Der MCP-Server für externe Clients

git clone <this-repo>
cd kicad-mcp

# Linux / WSL / macOS:
./install.sh
# Windows (PowerShell):
.\install.ps1

Der Installer prüft KiCad 10, registriert den Server bei Claude Code (falls claude installiert) und druckt Copy-Paste-JSON für Claude Desktop, Cursor, Windsurf, VS Code, Continue.dev und Zed. Start-Kommandos: start_mcp_wsl.sh (Linux/WSL/macOS) bzw. start_mcp.bat (Windows). Der Server läuft unter KiCads gebündeltem Python — keine separate Python-Installation nötig. Falls KiCad nicht gefunden wird: KICAD_PYTHON_PATH auf die python.exe im KiCad-bin/ setzen.

Warm-Server & Umgebungs-Schalter

Standard-Transport ist stdio (Claude startet den Server pro Nachricht). Mit KICAD_MCP_TRANSPORT=http hält das Plugin einen persistenten lokalen Server pro KiCad-Sitzung warm (strikt 127.0.0.1, zufälliges Bearer-Token, Pidfile-Verwaltung, Health-Check je Zug, atexit-Teardown). Rollback ist jederzeit ein Env-Wort.

Diagnose: Der Diagnose-Knopf im Einrichtungs-Panel sammelt Pfade, Versionen, Transport-Status (läuft der Warm-Server? PID, Port, Uptime, MCP-Ping) und die echte Server-Probe in einen kopierbaren Report.

Tool-Familien (186 Tools)

Single Source of Truth ist kicad_mcp/tool_registry.py (der Drift-Wächter tests/test_tool_audit.py pinnt die Zahl); jede Tool-Docstring erklärt „wann dieses, wann das Nachbar-Tool". Die Familien:

Architektur in einem Absatz

Der Server läuft unter KiCads gebündeltem Python (kipy + pcbnew erreichbar) und spricht wahlweise stdio oder streamable-HTTP. Drei Editier-Wege, je nach Situation: Text-Patcher (chirurgische .kicad_pcb/.kicad_sch-Edits, headless), IPC-Live-Tools (mutieren das In-Memory-Modell der offenen GUI — Pflicht, wenn das Board offen ist; ein Disk-Write-Guard blockt Kollisionen) und Generatoren (neue Dateien aus Specs). Ein zentraler kipy-Session-Layer recycelt die Verbindung mit Health-Check und Busy-Backoff; Warm-Board-Daemons amortisieren Load+Fill über wiederholte Abfragen; ein stat-revalidierter File-Cache killt redundante Reads. Verhaltensregeln gegen Toolcall-Explosionen (nicht nach jeder Mini-Änderung rendern, Batch vor Einzeln, Result lesen statt Rücklesen) stehen in CLAUDE.md und in jeder Mutations-Docstring.

Bekannte KiCad-10-Grenze: Eeschema hat kein IPC-Save/RunAction (KiCad #2077) — Schaltplan-Edits laufen dateibasiert bei geschlossenem Eeschema, Live-ERC über kicad-cli. Der 3D-Viewer hat keine API.

Credits & Origins

This project builds on the work of others and adds significant new functionality:

lamaalrajih/kicad-mcp — Foundation

The core server architecture, including FastMCP integration, async tool registration, project discovery, DRC with history tracking, BOM analysis, netlist extraction, circuit pattern recognition, and the security layer (path validation, secure subprocess runner). Originally MIT licensed upstream; this fork as a whole is GPL-3.0-or-later (see License).

Seeed-Studio/kicad-mcp — Inspiration

Conceptual model for ERC integration, schematic/PCB analysis tools, pin function inference, and hierarchical sheet handling. The implementations here are rewritten from scratch on our own S-expression parser.

Built for This Project

Everything else: the KiCad chat plugin (docked panel, cross-probe links, change receipts, super-feature bar, setup/diagnose, self-updater, warm-server lifecycle), the S-expression engine, schematic/PCB generation from JSON, ESPHome/LTspice converters, the PCB text-patcher + geometry/routing layers, the schematic-patch layer, the IPC live bridge incl. sketch-layer tooling and live diff, warm-board daemons, the semantic audit registry, the norm/physics tools (check_ampacity, run_spice_sim, get_safety_spacing with dated standards snapshots), footprint search, pcb_render, and the cross-environment path layer (WSL ↔ Windows).

Generation Input Format

The generation tools accept JSON strings. Example:

{
  "parts": [
    {
      "ref": "U1",
      "name": "ESP32-C6",
      "footprint": "RF_Module:ESP32-C6-MINI-1",
      "value": "ESP32-C6",
      "pins": [
        {"num": 1, "name": "VCC", "type": "power_in"},
        {"num": 2, "name": "GND", "type": "power_in"},
        {"num": 3, "name": "IO17", "type": "bidirectional"}
      ]
    },
    {
      "ref": "R1",
      "name": "R",
      "footprint": "Resistor_SMD:R_0805_2012Metric",
      "value": "10k",
      "pins": [
        {"num": 1, "name": "1", "type": "passive"},
        {"num": 2, "name": "2", "type": "passive"}
      ]
    }
  ],
  "nets": [
    {"name": "VCC", "type": "power", "connections": ["U1:VCC", "R1:1"]},
    {"name": "GND", "type": "power", "connections": ["U1:GND", "R1:2"]},
    {"name": "SDA", "type": "signal", "connections": ["U1:IO17"]}
  ],
  "board": {"shape": "rectangle", "width": 50, "depth": 30, "layers": 2, "thickness": 1.6}
}

Pin types: input, output, bidirectional, tri_state, passive, power_in, power_out, open_collector, open_emitter, free, unspecified, no_connect · Board shapes: rectangle, circle, euro_divider (euro_type: 3U, 6U, half_euro)

ESPHome YAML to KiCad

Paste an ESPHome YAML config and get a complete KiCad project — ESP module with correct pinout, sensors on their buses with pull-ups, decoupling caps per IC, power nets, .kicad_sch + .kicad_pcb + .kicad_pro:

esphome: {name: weather-station}
esp32: {board: esp32dev}
i2c: {sda: 21, scl: 22}
sensor:
  - {platform: bme280, address: 0x76}
  - {platform: bh1750, address: 0x23}
light:
  - {platform: neopixelbus, pin: GPIO16, num_leds: 30}

Supported platforms: BME280, BME680, DHT22, DS18B20, SHT31, BH1750, VL53L0X, MPU6050, ADS1115, SSD1306, WS2812B — extendable via the component database. Add simulation=True for SPICE-ready schematics.

Process Supervisor (optional, stdio clients)

_tasks/mcp_supervisor/ ships a thin JSON-RPC-transparent wrapper for external stdio clients: auto-respawn on child crash + an injected restart_mcp_child tool for wedged sessions. Point your client at start_mcp_supervisor.sh instead of start_mcp_wsl.sh; details in _tasks/mcp_supervisor/README.md. (The in-KiCad plugin doesn't need it — the warm-server manager has its own health-check/restart cycle.)

Development

pip install -e ".[dev]"
pytest tests/          # ~2700 tests; KiCad-/kipy-gebundene skippen headless
pylint --rcfile=pyproject.toml --disable=C,R kicad_mcp tests   # CI-Gate: 0/0
sh scripts/setup-hooks.sh   # einmalig: pre-commit spiegelt kicad_mcp/ → plugin/mcp/

Konventionen für neue Tools (Pfad-Normalisierung, Registry, Batch-Companions, Tests, Tool-Count-Wächter) stehen in CLAUDE.md. Logs: ~/.kicad-mcp/logs/kicad-mcp.log; IPC-Log neben dem Board (kicad_mcp_ipc.log).

License

GPL-3.0-or-later — see LICENSE.

This project loads KiCad's pcbnew Python module in-process (for PCB geometry, connectivity and via analysis). pcbnew is part of KiCad and licensed under GPL-3.0; combining with it makes the project as a whole GPL-3.0-or-later. See NOTICE for the rationale and third-party components.

Portions derive from the upstream kicad-mcp by Lama Al Rajih, originally under the MIT License (GPL-compatible) — the original notice is preserved in LICENSE.MIT.