KiCAD-MCP-Server Logo # KiCAD MCP Server [🇺🇸 **English** (EN)](#english)  â€˘  [🇩🇪 **Deutsch** (DE)](#deutsch) [![License](https://img.shields.io/badge/license-MIT-blue.svg)](../LICENSE) [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)](../docs/PLATFORM_GUIDE.md) [![KiCAD](https://img.shields.io/badge/KiCAD-9.0+-green.svg)](https://www.kicad.org/) [![Stars](https://img.shields.io/github/stars/mixelpixx/KiCAD-MCP-Server.svg)](https://github.com/mixelpixx/KiCAD-MCP-Server/stargazers) [![Discussions](https://img.shields.io/badge/community-Discussions-orange.svg)](https://github.com/mixelpixx/KiCAD-MCP-Server/discussions)
--- ## English **KiCAD MCP Server** is a Model Context Protocol server that lets AI assistants like Claude control KiCAD for schematic and PCB design workflows — using natural language. ### Design PCBs with natural language Describe what you want to build — and let AI handle the EDA work. Place components, create custom symbols and footprints, route connections, run checks, and export production files, all by talking to your AI assistant. No fighting menus, no looking up obscure settings. ### What it can do today - Project setup, schematic editing, component placement, routing, DRC/ERC, export - **Custom symbol and footprint generation** — for modules not in the standard KiCAD library - **Personal library management** — create once, reuse across projects - **JLCPCB integration** — parts catalog with pricing and stock data - **Freerouting integration** — automatic PCB routing via Java/Docker - **Visual feedback** — snapshots and session logs for traceability - **Cross-platform** — Windows, Linux, macOS ### Quick Start 1. Install [KiCAD 9.0+](https://www.kicad.org/download/) 2. Install [Node.js 18+](https://nodejs.org/) and [Python 3.11+](https://www.python.org/) 3. Clone and build: ```bash git clone https://github.com/mixelpixx/KiCAD-MCP-Server.git cd KiCAD-MCP-Server npm install npm run build ``` 4. Configure Claude Desktop — see [Platform Guide](../docs/PLATFORM_GUIDE.md) ### Documentation - [Quick Start (Router Tools)](../docs/ROUTER_QUICK_START.md) — first steps - [Tool Inventory](../docs/TOOL_INVENTORY.md) — all available tools - [Schematic Tools Reference](../docs/SCHEMATIC_TOOLS_REFERENCE.md) - [Routing Tools Reference](../docs/ROUTING_TOOLS_REFERENCE.md) - [Footprint & Symbol Creator Guide](../docs/FOOTPRINT_SYMBOL_CREATOR_GUIDE.md) - [JLCPCB Usage Guide](../docs/JLCPCB_USAGE_GUIDE.md) - [Platform Guide](../docs/PLATFORM_GUIDE.md) - [Changelog](../CHANGELOG.md) ### Community - [Discussions](https://github.com/mixelpixx/KiCAD-MCP-Server/discussions) — questions, ideas, showcase - [Issues](https://github.com/mixelpixx/KiCAD-MCP-Server/issues) — bugs and feature requests - [Contributing](../CONTRIBUTING.md) ### AI Disclosure > **Developed with AI Assistance** > This project was developed with the support of AI-assisted coding tools (GitHub Copilot, Claude). > All code has been reviewed, tested, and integrated by the maintainers. > AI tools were used to accelerate development — creative decisions, architecture, and responsibility remain entirely with the authors. --- ## Deutsch **KiCAD MCP Server** ist ein Model Context Protocol Server, der KI-Assistenten wie Claude ermöglicht, KiCAD für Schaltplan- und PCB-Workflows per natürlicher Sprache zu steuern. ### PCBs mit natürlicher Sprache designen Beschreibe was du bauen möchtest — und lass die KI die EDA-Arbeit übernehmen. Bauteile platzieren, eigene Symbole und Footprints erstellen, Verbindungen routen, Prüfungen ausführen und Fertigungsdateien exportieren — alles im Gespräch mit deinem KI-Assistenten. Kein Menü-Kampf, kein Nachschlagen obskurer Einstellungen. ### Was es heute kann - Projektanlage, Schaltplan-Bearbeitung, Bauteil-Platzierung, Routing, DRC/ERC, Export - **Eigene Symbole und Footprints generieren** — auch für Module die in KiCAD-Standardbibliotheken fehlen - **Eigene Bibliotheksverwaltung** — einmal erstellt, in jedem Projekt wiederverwendbar - **JLCPCB-Integration** — Bauteilkatalog mit Preisen und Lagerbestand - **Freerouting-Integration** — automatisches PCB-Routing via Java/Docker - **Visuelles Feedback** — Snapshots und Session-Logs für Nachvollziehbarkeit - **Plattformübergreifend** — Windows, Linux, macOS ### Schnellstart 1. [KiCAD 9.0+](https://www.kicad.org/download/) installieren 2. [Node.js 18+](https://nodejs.org/) und [Python 3.11+](https://www.python.org/) installieren 3. Klonen und bauen: ```bash git clone https://github.com/mixelpixx/KiCAD-MCP-Server.git cd KiCAD-MCP-Server npm install npm run build ``` 4. Claude Desktop konfigurieren — siehe [Plattform-Anleitung](../docs/PLATFORM_GUIDE.md) ### Dokumentation - [Schnellstart (Router Tools)](../docs/ROUTER_QUICK_START.md) — erste Schritte - [Werkzeug-Übersicht](../docs/TOOL_INVENTORY.md) — alle verfügbaren Werkzeuge - [Schaltplan-Werkzeuge](../docs/SCHEMATIC_TOOLS_REFERENCE.md) - [Routing-Werkzeuge](../docs/ROUTING_TOOLS_REFERENCE.md) - [Footprint & Symbol erstellen](../docs/FOOTPRINT_SYMBOL_CREATOR_GUIDE.md) - [JLCPCB-Anleitung](../docs/JLCPCB_USAGE_GUIDE.md) - [Plattform-Anleitung](../docs/PLATFORM_GUIDE.md) - [Changelog](../CHANGELOG.md) ### Community - [Diskussionen](https://github.com/mixelpixx/KiCAD-MCP-Server/discussions) — Fragen, Ideen, Projekte zeigen - [Issues](https://github.com/mixelpixx/KiCAD-MCP-Server/issues) — Fehler und Feature-Wünsche - [Mitwirken](../CONTRIBUTING.md) ### KI-Hinweis > **Entwickelt mit KI-Unterstützung** > Dieses Projekt wurde unter Einsatz von KI-gestützten Entwicklungswerkzeugen (GitHub Copilot, Claude) erstellt. > Sämtlicher Code wurde von den Maintainern geprüft, getestet und integriert. > KI-Werkzeuge dienten der Entwicklungsbeschleunigung — kreative Entscheidungen, Architektur und Verantwortung liegen ausschließlich bei den Autoren.