kicad-mcp-pro

KiCad MCP Pro ist ein Model Context Protocol-Server für KiCad-EDA-Workflows. Es stellt Werkzeuge, Ressourcen und Prompts für die Automatisierung von Schaltplänen, Leiterplatten, Validierung, DFM und Fertigungsexport bereit.

Der Server startet jetzt mit dem begrenzten default-Profil: 24 schreibgeschützte Überprüfungswerkzeuge anstelle des vollständigen 377-Werkzeug-Expertenkatalogs. Verwenden Sie build mit Schreibmodus für kontrollierte Bearbeitungen, release mit Fertigungsmodus für menschlich gesteuerte Übergabe oder expert/full nur für fortgeschrittene vertrauenswürdige Clients. Siehe docs/agents/progressive-disclosure.md.

Telemetrie und Fehlerberichterstattung sind standardmäßig deaktiviert. Die optionale OpenTelemetry-Konfiguration ist in docs/configuration.md dokumentiert, und die Datenschutzregeln sind in docs/privacy.md dokumentiert.

Umfang und Ehrlichkeit

KiCad MCP Pro ist ein professioneller erster Entwurfs- und Überprüfungsassistent, keine automatisierte Freigabeinstanz. ERC/DRC und die Export-Pipeline treiben KiCads eigene Engines an. Die Werkzeuge für Signalintegrität, Leistungsintegrität, EMV und thermische Analyse sind Näherungen erster Ordnung in geschlossener Form (typischerweise ~5–10% Genauigkeit) – schnelle erste Überprüfung, kein Ersatz für einen 2D/3D-Feldlöser, EM/FEA-Simulation oder formelle Freigabe. Die Live-Bauteilbeschaffung verwendet standardmäßig den öffentlichen JLCPCB-Katalog; Nexar, DigiKey und Mouser sind nur verfügbar, wenn ihre API-Anmeldeinformationen konfiguriert sind. Welcher Anteil von KiCads programmatischer Oberfläche vom Server gesteuert wird, wird offen in der Fähigkeitsparitätsmatrix verfolgt.

Related MCP server: KiCad MCP Server

Projektidentität

Schnellstart

Desktop-Anwendung

Laden Sie das neueste Installationsprogramm von der GitHub-Releases-Seite herunter. Die Tauri-Desktop-Anwendung startet den Python-Dashboard-Server automatisch und öffnet die GUI unter http://127.0.0.1:3334/ui. Desktop-Releases starten die exakt passende Backend-Version und überprüfen vor der Verwendung den Desktop-Kompatibilitäts-Handshake; siehe Installation.

CLI

uvx kicad-mcp-pro init
uvx kicad-mcp-pro tray
uvx kicad-mcp-pro dashboard --open
uvx kicad-mcp-pro --transport streamable-http --port 3334

Web-Dashboard

uvx kicad-mcp-pro dashboard --host 127.0.0.1 --port 3334 --open
# http://127.0.0.1:3334/ui

Dokumentation

Die Dokumentation ist von der Einrichtung bis zum Betrieb organisiert:

1. Installation

2. Client-Konfiguration

3. Laufzeitkonfiguration

4. Werkzeugreferenz

5. Workflows

6. Release-Prozess

7. Sicherheit und Datenschutz

8. KiCad-Fähigkeitsparität — wie viel von KiCads programmatischer Oberfläche dieser Server steuert

9. Fehlercode-Katalog — stabile Fehlercodes, Wiederholungsklassen und Wiederherstellung

10. Arbeitsauftragsprüfung — aktueller Status des Härtungsarbeitsauftrags

Das Werkzeug kicad_capability_parity() berichtet pro Workflow-Domäne, welchen Anteil von KiCads programmatisch erreichbarer Oberfläche dieser Server steuern kann (derzeit 76,3%), wobei echte gaps von gui-only-no-api-Elementen unterschieden werden, für die KiCad keine Headless-API bereitstellt.

Die veröffentlichte Dokumentationsseite ist verfügbar unter https://oaslananka.github.io/kicad-mcp-pro/.

Transporte

KiCad MCP Pro unterstützt stdio und Streamable HTTP. Streamable HTTP wird standardmäßig unter /mcp bereitgestellt und kann mit KICAD_MCP_MOUNT_PATH verschoben werden.

uvx kicad-mcp-pro --transport streamable-http --host 127.0.0.1 --port 3334

Streamable HTTP-Clients müssen senden:

• Accept: application/json, text/event-stream

• Content-Type: application/json

• MCP-Protocol-Version: 2025-11-25 nach der Initialisierung

• MCP-Session-Id bei Folgeanfragen, wenn KICAD_MCP_STATEFUL_HTTP=1

Standardmäßig ist Streamable HTTP zustandslos, sodass ChatGPT-ähnliche Konnektoren initialisieren und tools/list ohne einen Session-Header-Injektions-Proxy aufrufen können. Setzen Sie KICAD_MCP_STATEFUL_HTTP=1, um nach initialize Session-IDs zu verlangen.

Die veralteten HTTP+SSE-Fallback-Routen sind standardmäßig deaktiviert. Setzen Sie KICAD_MCP_LEGACY_SSE=1 nur für ältere Clients, die Streamable HTTP nicht verwenden können.

Installieren

Veröffentlichte Pakete:

uvx kicad-mcp-pro --help
npx kicad-mcp-pro --help

Frischer Quellcode-Checkout auf unterstützten Linux-Hosts:

./scripts/bootstrap-dev.sh
source .dev-env.sh
pnpm run dev:doctor -- --ci

Das Repository-Bootstrap installiert checksummen-verankerte Python-, uv/uvx-, Node.js-, pnpm-, Task- und Rust-Toolchains in ignorierte checkout-lokale Wurzeln und führt eine eingefrorene Abhängigkeitsinstallation durch. Es ändert keine globalen Tool-Verzeichnisse. Siehe den reproduzierbaren Bootstrap-Leitfaden für --core-only, --check, Bereinigung, Upgrade und KiCad-Fähigkeitsmodi.

Paketmetadaten

Die kanonischen Metadateneingaben sind pyproject.toml für Paketversion und Repository-Identität und compatibility.yaml für die KiCad- und MCP-Supportrichtlinie. server.json ist das generierte Registry-Manifest. pnpm run metadata:sync rendert die öffentlichen Oberflächen, und pnpm run metadata:check überprüft sie in CI und Release-Validierung.

Verwendung

Verwenden Sie kicad-mcp-pro --help, um CLI-Befehle zu inspizieren, und docs/client-configuration.md, um einen MCP-Client zu konfigurieren. Der generierte Werkzeugkatalog ist in docs/tools-reference.generated.md verfügbar.

Agenten-Plugin und Fähigkeiten

Dieses Repository enthält das produktbezogene Agenten-Plugin und die KiCad-spezifischen Fähigkeiten für KiCad MCP Pro. Das zentrale agent-tools-Repository sollte dieses Plugin katalogisieren, aber das Manifest und die Workflow-Anweisungen befinden sich hier, damit sie mit den tatsächlichen MCP-Server-Werkzeugen synchron bleiben.

Agenten-Einrichtung

KiCad MCP Pro kann mit dem veröffentlichten Python-Paket, dem npm-Wrapper oder den in server.json deklarierten Container-Metadaten gestartet werden. Übliche lokale Starts sind:

uvx kicad-mcp-pro --transport stdio
uvx kicad-mcp-pro --transport streamable-http --host 127.0.0.1 --port 3334
npx kicad-mcp-pro --help

Bei Quellcode-Checkouts führen Sie vor der Veröffentlichung von Plugin-Änderungen den normalen Repository-Validierungspfad aus:

corepack pnpm run metadata:check
python3 -m json.tool .claude-plugin/plugin.json >/dev/null

Validierungs-Workflow

Bevor Sie dieses Plugin als aktiv in agent-tools auflisten, überprüfen Sie, dass mindestens eine kompatible Agenten-Laufzeitumgebung Folgendes kann:

1. .claude-plugin/plugin.json erkennen.

2. kicad-mcp-pro über stdio oder Streamable HTTP starten oder verbinden.

3. kicad_get_server_info oder kicad_get_project_info aufrufen.

4. Einen Skill aus skills/ laden und dem Workflow folgen, ohne auf fehlende Tools zu verweisen.

5. ERC, DRC, DFM, Export-Artefakte, Annahmen und Anforderungen an die menschliche Überprüfung separat melden.

KiCad MCP Pro ist ein technischer Assistent, keine autonome Fertigungsfreigabeinstanz. Generierte PCB- und Fertigungsausgaben erfordern vor der Fertigung oder Montage eine qualifizierte menschliche Überprüfung.

Entwicklung

Neue Mitwirkende sollten mit ARCHITECTURE.md beginnen, das die fünf Schichten (Transport → MCP-Protokoll → Orchestrierung → KiCad-Adapter-Naht → reine Domäne) abbildet und genau zeigt, wie ein neues Tool hinzugefügt wird. Das Laufzeitmodell und der Qualitätsgate-Stack sind in docs/development/architecture.md dokumentiert.

Das Projekt verwendet eine Taskfile.yml für allgemeine Entwicklungsbefehle. Nach dem Klonen des Repositorys:

task install     # Install all dependencies (pnpm + uv)
task verify      # Run the local quality gate: lint → format → typecheck → test → build
task test        # Run unit tests only
task lint        # Run lint and metadata checks
task format      # Auto-format the codebase
task typecheck   # Run strict static type checking
task build       # Build release artifacts
task ci          # Run the local equivalent of the full CI pipeline
task hooks       # Install local git hooks

Alle Änderungen müssen task verify bestehen, bevor ein Pull-Request geöffnet wird.

Mitwirken

Lesen Sie CONTRIBUTING.md, bevor Sie einen Pull-Request öffnen. Alle Änderungen müssen die Format-, Lint-, Typprüfungs-, Test-, Workflow-, Sicherheits- und Paketmetadaten-Gates des Repositorys bestehen.

Diese Software zitieren

Wenn Sie KiCad MCP Pro in der Forschung oder einer technischen Veröffentlichung verwenden, zitieren Sie die archivierte Version über ihre DOI (siehe CITATION.cff für vollständige Metadaten):

@software{aslan_kicad_mcp_pro,
  author  = {Aslan, Osman},
  title   = {KiCad MCP Pro},
  license = {MIT},
  url     = {https://github.com/oaslananka/kicad-mcp-pro},
  doi     = {10.5281/zenodo.21283791}
}

Jede GitHub-Version wird auf Zenodo unter dieser Konzept-DOI archiviert, die immer auf die neueste Version verweist.

Lizenz

KiCad MCP Pro ist unter der MIT-Lizenz verfügbar.