KiCad Agentic MCP

KI-gestütztes PCB-Design für KiCAD 10. Konnect ist ein natives KiCAD-Plugin – eine einzelne Rust-Binärdatei –, das Claude und anderen KI-Assistenten das Entwerfen von Schaltplänen und Leiterplatten über das Model Context Protocol (MCP) ermöglicht.

202 Tools in 22 bedarfsgesteuerten Toolsets. Schaltplanerfassung, PCB-Layout und Routing, ERC/DRC, Design-Review-Audits, JLCPCB-Teilesuche, Freerouting, Referenzschaltungen und eine vollständige Fertigungsexport-Pipeline – mit integrierten Skills und Agents, die Claude die KiCAD-Konventionen von Haus aus beibringen.

Dieses Repository ist KiCad Agentic MCP, ein agentischer Fork von mixelpixx/Konnect v0.2.2, unter derselben AGPL-3.0-Lizenz. Zusätzlich zur Tool-Oberfläche von Konnect fügt es ein MCP-Gateway, einen Plan-IR mit deterministischem Executor, Evidenz-Handles, Aufgabenstatus und eine lokale Modell-Laufzeit hinzu. Die Server-Binärdatei heißt weiterhin konnect.

Status: v1.1.1. Was es misst, was es vermisst und was es nicht abdeckt, steht in RELEASE_NOTES.md; jede unten zitierte Zahl führt auf docs/benchmark.md zurück. Issues und PRs sind willkommen – siehe CONTRIBUTING.md und die Namenskonventionen.

Was ein einziger Prompt bewirkt

Ein einziger Prompt, auf der Startplatine, die in examples/demo/ eingecheckt ist – reproduzierbar, nicht illustrativ. KiCADs Urteil, nicht unseres: 5 nicht verbundene Elemente vorher, 0 nachher, 11 Bahnsegmente, keine Fehler; zweimal vom selben Zustand aus ausgeführt, beide Male dieselbe Schaltung, unterschiedliche Koordinaten.

Zwei Zahlen, weil sie zwei verschiedene Dinge messen: Die Platinenänderungen landen in unter einer Sekunde (0,69 s und 0,77 s Konnect-Zeit), während der Prompt darum herum 6 bis 7 Minuten dauert, weil das Modell ein Segment pro Zug routet. Beide Läufe, pro Aufruf, sind in demo-run-2.md und demo-run-3.md.

Related MCP server: KiCad MCP Pro

Schnellstart

Fünf Schritte von der Release-Seite zu einer Änderung, die KiCAD selbst bestätigt. Durchgeführt auf einer Maschine, auf der Konnect nie installiert war; der Bericht, einschließlich dessen, was schiefging, ist docs/launch/first-run-walk.md.

Was dieser Durchlauf gemessen hat: etwa neun Klicks und Dialoge zwischen dem Start von KiCAD und einem installierten Plugin, zwei KiCAD-Neustarts und eine erste Aufgabe, die in 108 ms zurückkam. Die Gesamtzeit wird davon dominiert, wie schnell Sie klicken, daher wird sie nicht als Zahl angegeben.

Bevor Sie beginnen, benötigen Sie KiCAD 10 (getestet gegen 10.0.3) und einen MCP-Client – Claude Desktop, Claude Code oder etwas anderes, das MCP spricht. Sonst nichts: kein Node, kein Python, kein Paketbaum. Windows ist die am besten getestete Plattform; siehe Anforderungen für den Stand von macOS und Linux.

1 – Laden Sie das Plugin-Paket herunter. Von Releases nehmen Sie konnect-pcm-v<version>-windows.zip (oder -macos.zip / -linux.zip). Die konnect-pcm-*-Assets sind die KiCAD-Plugin-Pakete; die anderen Archive sind eigenständige Server-Binärdateien, die Sie für diesen Pfad nicht benötigen.

2 – Installieren Sie es. KiCAD 10 → Plugin- und Inhaltsmanager → Aus Datei installieren… → wählen Sie die Zip-Datei. Es installiert sich in dem Moment, in dem Sie die Datei auswählen – der Apply Pending Changes-Button bleibt ausgegraut und es gibt nichts weiter zu bestätigen. Starten Sie KiCAD neu.

3 – Aktivieren Sie die KiCAD-API. Einstellungen → Plugins → aktivieren Sie KiCad-API aktivieren, dann starten Sie KiCAD neu. KiCAD liefert diese deaktiviert aus, und jedes PCB-Tool hier spricht über sie mit KiCAD. Schaltplanbearbeitung und Exporte funktionieren ohne sie; Live-Platinenbearbeitung nicht. Nach dem Neustart sollte dieselbe Seite Listening on ipc://… anzeigen.

4 – Richten Sie Ihren MCP-Client auf den Server aus. Nach einer PCM-Installation befindet sich die Binärdatei in Ihrem KiCAD-Dokumentenordner:

C:\Users\<YOU>\Documents\KiCad\10.0\3rdparty\plugins\com_github_mixelpixx_konnect\bin\konnect.exe

Setzen Sie diesen Pfad in die MCP-Konfiguration Ihres Clients – %APPDATA%\Claude\claude_desktop_config.json für Claude Desktop, eine .mcp.json im Projektstamm für Claude Code. Kopier- und Einfügeversionen beider befinden sich in examples/, und die vollständigen Ausschnitte sind weiter unten. Starten Sie den Client neu; konnect sollte beim Start 21 Tools melden. Das ist das gesamte Starter-Kit – der Rest des Katalogs wird bei Bedarf geladen oder über das Gateway aufgerufen, ohne jemals in tools/list zu erscheinen. Keine konnect-settings.json ist erforderlich für eine Standard-KiCAD-10-Installation: v1.1.1 findet kicad-cli, die KiCAD-GUI-Binärdatei und die IPC-Adresse. Explizite Einstellungen bleiben für ungewöhnliche oder portable Installationen verfügbar.

5 – Geben Sie ihm etwas zu tun, mit einem geöffneten KiCAD-Projekt. Zum Beispiel:

Fügen Sie meinem Schaltplan eine 3,3-V-LDO-Regler-Teilschaltung hinzu und führen Sie ERC darauf aus.

Die Antwort sollte die platzierten Bauteile nennen – einen Regler, seine Eingangs- und Ausgangskondensatoren – und ein ERC-Ergebnis enthalten, das von kicad-cli stammt, nicht vom Modell. Öffnen Sie den Schaltplan in KiCAD: Die Symbole sind da.

Überprüfen Sie die Installation selbst jederzeit: Öffnen Sie ein Projekt (der PCB-Editor von KiCAD weigert sich, ohne eines zu öffnen), dann PCB-Editor → Werkzeuge → Externe Plugins, wo Sie Konnect sehen sollten.

Was dies noch nicht tut

• PCB-Tools benötigen ein laufendes KiCAD mit aktivierter API und geöffneter Platine. Es gibt keinen Headless-PCB-Pfad – pcbnew hat keinen.

• macOS-Binärdateien sind nicht signiert oder notarisiert. Gatekeeper stoppt sie beim ersten Start; der macOS-Abschnitt enthält den genauen xattr-Befehl.

• Linux kompiliert und besteht CI, hatte aber keine plattformspezifische QA gegen ein laufendes KiCAD.

• Symbole und Footprints werden platziert, nicht erstellt. Konnect sucht und verwendet vorhandene Bibliotheksbauteile; das Erstellen neuer steht auf der Roadmap.

Wenn einer dieser fünf Schritte bei Ihnen nicht funktioniert hat, ist das die Sache, die es wert ist, zu melden: Erstlauf-Bericht einreichen. Es dauert etwa zwei Minuten und ist der einzige Weg, wie dies auf einer Maschine gemessen wird, die nicht die des Maintainers ist.

Warum Konnect existiert

Konnect ist der Nachfolger von KiCAD-MCP-Server, einem Python/TypeScript-Projekt, das bewiesen hat, dass KI-gesteuertes PCB-Design funktioniert – und dabei genau zeigte, wo diese Architektur an ihre Grenzen stößt. Konnect wurde gebaut, um genau diese Probleme zu beheben:

Der Aufrufpfad war zu lang. Im ursprünglichen Server reist ein einzelner Tool-Aufruf durch TypeScript, Schema-Validierung, einen erzeugten Python-Subprozess, JSON über stdin/stdout, einen Befehlsrouter und schließlich SWIG-generierte C++-Proxy-Objekte, bevor etwas Ihre Platine berührt. Das sind vier Sprach- und Serialisierungsgrenzen, jede mit eigenen Fehlermodi – Subprozess-Lebenszyklusverwaltung, stdout-Parsing, das Warnungen herausfiltert, die KiCAD in den Stream leakt, Chunked-JSON-Rekonstruktion. In Konnect ist ein Tool-Aufruf ein Funktionsaufruf. Ein Prozess, eine Sprache, keine Rohrleitungen.

Die Abhängigkeitsoberfläche war enorm. Das Ausführen des Originals bedeutet, Node.js und seinen npm-Baum, Python und seine pip-Pakete, wxPython, kicad-skip und KiCADs SWIG-Bindings mitzutragen – zwei Paket-Ökosysteme plus eine Bindungsschicht, jede davon ein bewegliches Ziel, das eine Installation brechen kann. Konnect ist eine Binärdatei – 24 MB auf Windows, kein Interpreter, kein Paketbaum. Es gibt nichts, was daneben installiert werden muss, und nichts, was versionstechnisch abgeglichen werden muss.

SWIG ist eine Sackgasse. Das PCB-Backend des Originals hängt von KiCADs SWIG-Python-Bindings ab, die KiCAD zugunsten seiner IPC-API auslaufen lässt. SWIG trug auch echte operative Narben: einen Zonenfüll-Aufruf, der das Backend zum Absturz bringen kann, Proxy-Objekt-Vergleichsfehler und einen Fallback-Pfad, der mitten in der Sitzung stillschweigend das Backend wechseln kann. Konnect spricht mit KiCAD 10 über die offizielle IPC-API (Protobuf über NNG) – die Schnittstelle, in die KiCAD investiert – mit Echtzeit-Platinenbearbeitung, die in KiCADs eigenes Undo/Redo integriert ist.

Schaltplanbearbeitung sollte keine Dateien beschädigen. Konnect bearbeitet .kicad_sch-Dateien über eine eigene S-Expression-Engine mit atomaren Schreibvorgängen (write, fsync, rename), UUID-Erhaltung und Round-Trip-Tests – keine Drittanbieter-Schaltplanbibliothek mit bekannten Lücken, keine Textmanipulations-Workarounds.

Kontextökonomie ist ein Feature. Den gesamten Katalog auszuliefern – 215 Tools, sobald jedes Toolset geladen ist – kostet 33K Tokens Kontext bei jeder Auflistung. Konnects Router startet mit einem Starter-Kit von 21 Tools / 2,8K Tokens und lässt das Modell Toolsets bei Bedarf nachladen oder den Katalog ganz überspringen und Tools über das Gateway aufrufen (kicad_describe / kicad_invoke), das tools/list überhaupt nie ändert – plus integrierte Beobachtbarkeit (get_recent_calls, server_stats, JSONL-Aufrufprotokolle), damit das Modell seine eigenen Tool-Fehler diagnostizieren kann. Diese Zahlen sind gemessen, nicht geschätzt: siehe docs/benchmark.md.

Das Ergebnis ist kleiner, schneller zu installieren, ausgerichtet auf KiCADs Zukunft und für den Produktionseinsatz gebaut statt für Experimente. Das ursprüngliche Projekt bleibt offen, gepflegt und nützlich – siehe den Vergleich unten.

Was es tut

Statt Änderungen zu beschreiben und von Hand anzuwenden, arbeitet die KI direkt an Ihrem Projekt:

• Schaltplan-Komponenten platzieren und verdrahten – Widerstände, ICs, Steckverbinder hinzufügen; sie per Pinnamen verbinden

• Die PCB entwerfen – Footprints in Echtzeit über KiCADs IPC-API platzieren, verschieben, drehen und routen, mit vollständiger Undo/Redo-Integration

• Designprüfungen ausführen – ERC, DRC, Konnektivitätsvalidierung, Entkopplungs-Audits, Stromversorgungs-Review, BOM-Gesundheitschecks

• Produktionsdateien exportieren – Gerber, Bohrdaten, BOM, Bestückungsdaten, 3D-Modelle, PDF

• JLCPCB-Teile suchen – verfügbare Komponenten in einem lokalen Katalog mit 2,5 Mio. Teilen finden und Alternativen vorschlagen

• Mit Referenzschaltungen starten – USB-C, LDO, Buck-Wandler, STM32, I2C, LED- Vorlagen mit verifizierten Bauteilwerten

• Zusehen, wie es passiert – ein Live-Schaltplan-Viewer aktualisiert sich automatisch, während die KI bearbeitet

Der vollständige Tool-Katalog ist in tool-directory.md dokumentiert.

So funktioniert es

Installation

Über den KiCAD-Plugin-Manager (empfohlen)

1. Laden Sie das Paket für Ihr Betriebssystem von Releases herunter: konnect-pcm-v<version>-windows.zip, -macos.zip oder -linux.zip. Jedes enthält die Server-Binärdatei der jeweiligen Plattform – das macOS-Paket ist ein universeller Build, sodass ein Download sowohl Apple Silicon als auch Intel abdeckt. (Die konnect-pcm-* Dateien sind die KiCAD-Plugin-Pakete; die anderen Archive sind eigenständige Server-Binärdateien.)

2. Öffnen Sie KiCAD 10 → Plugin- und Content-Manager

3. Klicken Sie auf Aus Datei installieren und wählen Sie die ZIP-Datei. Die Installation erfolgt bei der Auswahl – Ausstehende Änderungen anwenden bleibt ausgegraut, und es gibt nichts weiter zu bestätigen

4. Starten Sie KiCAD neu

5. Aktivieren Sie die KiCAD-API: Einstellungen → Plugins → KiCad-API aktivieren, dann starten Sie KiCAD erneut. Sie ist standardmäßig deaktiviert, und jedes PCB-Werkzeug benötigt sie

Überprüfung: Öffnen (oder erstellen) Sie ein Projekt – der PCB-Editor von KiCAD lässt sich ohne eines nicht öffnen – dann PCB-Editor → Werkzeuge → Externe Plugins → Sie sollten Konnect sehen.

Aus dem Quellcode erstellen

# protoc is required (protobuf code generation), and cmake (the nng crate
# compiles the NNG C library with it).
# Windows: choco install protoc cmake
# macOS:   brew install protobuf cmake
# Linux:   apt install protobuf-compiler cmake
cargo build --release -p konnect

macOS

Die Releases-Seite enthält eigenständige Server-Binärdateien für sowohl Apple Silicon (aarch64-apple-darwin) als auch Intel (x86_64-apple-darwin). Sie sind noch nicht codesigniert. Wenn Sie also eine über einen Browser herunterladen, entfernen Sie vor dem ersten Start das Quarantäne-Flag:

tar xzf konnect-v*-aarch64-apple-darwin.tar.gz
xattr -d com.apple.quarantine ./konnect   # only needed for browser downloads
./konnect --help

Oder erstellen Sie es wie oben aus dem Quellcode (auf Apple Silicon verifiziert; dieselbe target/release/konnect-Binärdatei ist der MCP-Server).

KiCad unter macOS hält seine Werkzeuge im App-Bundle und sie sind nicht im PATH; v1.1.1 durchsucht das Standard-App-Bundle und verwendet automatisch die Standard-IPC-Adresse von KiCad. Nur eine ungewöhnliche oder umbenannte Installation benötigt explizite Überschreibungen in ~/Library/Application Support/konnect/config.toml:

kicad_cli = "/Applications/KiCad/KiCad.app/Contents/MacOS/kicad-cli"
kicad_binary = "/Applications/KiCad/KiCad.app/Contents/MacOS/kicad"
# Optional override; the default is ipc:///tmp/kicad/api.sock.
ipc_address = "ipc:///tmp/kicad/api.sock"

Die Konfiguration von Claude Desktop befindet sich unter ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "konnect": {
      "command": "/path/to/konnect"
    }
  }
}

Für Claude Code fügen Sie denselben Ausschnitt in eine .mcp.json in Ihrem Projektstammverzeichnis ein.

Das PCM-Paket für macOS (konnect-pcm-v<version>-macos.zip) enthält eine universelle Server-Binärdatei, sodass ein Download beide Architekturen abdeckt. Der Schaltplan-Viewer kompiliert und startet unter macOS (Tauri 2 verwendet das systemeigene WKWebView – WebView2 ist nur eine Windows-Anforderung), hat aber noch nicht die gleiche Reife wie der Windows-Build.

Einrichtung mit Claude Desktop

Nach einer PCM-Installation befindet sich die Server-Binärdatei in Ihrem KiCAD-Dokumentenordner:

C:\Users\<YOU>\Documents\KiCad\10.0\3rdparty\plugins\com_github_mixelpixx_konnect\bin\konnect.exe

Bearbeiten Sie %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "konnect": {
      "command": "C:\\Users\\<YOU>\\Documents\\KiCad\\10.0\\3rdparty\\plugins\\com_github_mixelpixx_konnect\\bin\\konnect.exe"
    }
  }
}

Starten Sie Claude Desktop neu und die Konnect-Werkzeuge erscheinen. Für Claude Code fügen Sie denselben Ausschnitt in eine .mcp.json in Ihrem Projektstammverzeichnis ein (siehe examples/).

Schaltplan-Viewer

Ein eigenständiger Viewer, der automatisch aktualisiert, wenn sich die Schaltplandatei ändert:

schematic-viewer.exe path\to\your\root_schematic.kicad_sch

Richten Sie es auf das oberste Blatt eines hierarchischen Entwurfs aus, und jedes Unterblatt wird ebenfalls gerendert, mit einem tiefen-eingerückten Blattauswähler in der Symbolleiste. Von KiCAD gespeicherte Änderungen (oder durch die KI über die Schaltplan-Werkzeuge vorgenommene) rendern nur die geänderten Blätter neu und aktualisieren die Ansicht live – das Rendering erfolgt gegen Snapshots im temporären Ordner, sodass der Viewer KiCAD nie am Speichern hindert. Schwenken mit Klicken und Ziehen, Zoomen mit dem Mausrad, 0 zum Einpassen, R zum Aktualisieren, Ziehen und Ablegen zum Öffnen einer anderen Datei. Auch von der KI über das Werkzeug open_schematic_viewer startbar.

Benötigt die WebView2-Laufzeit (vorinstalliert auf Windows 10/11) und eine KiCAD-Installation für kicad-cli (automatisch erkannt, oder übergeben Sie --kicad-cli <Pfad>). Wird separat vom Hauptarbeitsbereich erstellt – siehe DEV.md für Build-Schritte.

Anforderungen

• KiCAD 10 (Windows ist die am meisten getestete Plattform; macOS funktioniert mit den Release-Binärdateien oder einem Quellcode-Build – siehe den macOS-Abschnitt oben. Linux kompiliert und besteht Tests in CI, hatte aber noch keine plattformspezifische Qualitätssicherung; beide sind auf der Roadmap verfolgt)

• kicad-cli (wird mit KiCAD geliefert – verwendet für Exporte, ERC, DRC). Es wird von KiCADs Installer nicht auf den PATH gesetzt; der Server durchsucht die üblichen Installationsorte, und Sie können es explizit angeben, wenn Ihres woanders liegt

• Für PCB-Werkzeuge: KiCAD läuft mit geöffneter Zielplatine, und die KiCAD-API ist aktiviert – Einstellungen → Plugins → KiCad-API aktivieren, die standardmäßig deaktiviert ist

Lizenz: kostenlos für die Kleinen

Konnect ist unter der GNU AGPL-3.0 lizenziert.

Wenn Sie ein Hobbyist, Student, Freiberufler oder Open-Source-Projekt sind: nutzen Sie es frei, ohne Bedingungen. Entwerfen Sie Platinen, bringen Sie sie auf den Markt, verkaufen Sie sie.

Wenn Sie ein Unternehmen sind: Die AGPL verlangt, dass alles, was Sie auf oder um Konnect herum bauen – einschließlich Software, die über ein Netzwerk bereitgestellt wird – unter derselben Lizenz als Open Source veröffentlicht wird. Wenn das für Sie nicht funktioniert, sind kommerzielle Lizenzen erhältlich: siehe COMMERCIAL.md.

Beziehung zu KiCAD-MCP-Server

Das ursprüngliche Python/TypeScript-Projekt bleibt vollständig offen (MIT) und wird gepflegt. Konnect ist der Ort, an dem die neue Entwicklung stattfindet – die Architektur, die es bewiesen hat, neu aufgebaut für die Produktion:

Fehlerbehebung

Plugin erscheint nicht in KiCAD – Installieren Sie über den Plugin- und Content-Manager (nicht manuell kopieren), dann starten Sie KiCAD neu. Der Eintrag befindet sich unter Werkzeuge → Externe Plugins im PCB-Editor, der sich erst öffnet, wenn ein Projekt geöffnet ist.

PCB-Werkzeuge melden „IPC connect failed" – Zwei getrennte Dinge müssen beide zutreffen: Einstellungen → Plugins → KiCad-API aktivieren ist aktiviert (KiCAD liefert es deaktiviert), und KiCAD läuft mit geöffneter Platinendatei. Die API-Seite sollte nach einem Neustart Listening on ipc://… anzeigen. docs/TROUBLESHOOTING.md führt durch beides.

„Failed to spawn kicad-cli" – Der Server sucht nach kicad-cli in dieser Reihenfolge: den kicad_cli-Wert in Ihrer Konfiguration, falls Sie einen festgelegt haben, dann PATH, dann die bekannten Installationspräfixe (einschließlich %LOCALAPPDATA%\Programs\KiCad\<ver>\bin, wo KiCADs Installer eine benutzerspezifische Installation ablegt), dann die Windows-Registrierung. Er protokolliert, welche beim Start geantwortet hat. Wenn keine – ein ungewöhnlicher Installationsort, eine tragbare Kopie – setzen Sie kicad_cli explizit im Plugin-Einstellungsdialog oder in Ihrer Konfigurationsdatei.

Ein Validator meldet einen Fehler statt null Befunde – das ist beabsichtigt. Eine Prüfung, die nicht ausgeführt werden konnte, wird nie als bestandene Prüfung gemeldet.

Unterstützung

• Zum ersten Mal ausprobiert? Erstbericht einreichen – sechs Fragen, die meisten mit einem Klick. Ein Bericht von jemandem, der aufgegeben hat, ist mehr wert als einer von jemandem, der erfolgreich war. Was zurückkommt, wird in docs/adoption.md erfasst.

• Fehler & Feature-Anfragen: GitHub Issues

• Festgefahren bei Installation oder IPC-Socket: docs/TROUBLESHOOTING.md

• Roadmap: ROADMAP.md

• Mitwirken: CONTRIBUTING.md

Keine Telemetrie. Konnect meldet nichts, nirgendwo, jemals. Alles, was darüber bekannt ist, wie es sich auf anderen Maschinen verhält, stammt von jemandem, der sich entschieden hat, es aufzuschreiben. Ein Werkzeug, das Ihre Designdateien bearbeitet, verdient Vertrauen, indem es nicht nach Hause telefoniert.