feat: add .github/README.md multilingual landing page with logo
This commit is contained in:
137
.github/README.md
vendored
Normal file
137
.github/README.md
vendored
Normal file
@@ -0,0 +1,137 @@
|
|||||||
|
<div align="center">
|
||||||
|
|
||||||
|
<img src="../resources/images/KiCAD-MCP-Server_only_css.svg" alt="KiCAD-MCP-Server Logo" height="240" />
|
||||||
|
|
||||||
|
# KiCAD MCP Server
|
||||||
|
|
||||||
|
[🇺🇸 **English** (EN)](#english) • [🇩🇪 **Deutsch** (DE)](#deutsch)
|
||||||
|
|
||||||
|
[](../LICENSE)
|
||||||
|
[](../docs/PLATFORM_GUIDE.md)
|
||||||
|
[](https://www.kicad.org/)
|
||||||
|
[](https://github.com/mixelpixx/KiCAD-MCP-Server/stargazers)
|
||||||
|
[](https://github.com/mixelpixx/KiCAD-MCP-Server/discussions)
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 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.
|
||||||
|
|
||||||
|
### Target Users
|
||||||
|
|
||||||
|
- Occasional PCB designers who know electronics but struggle with KiCAD tooling
|
||||||
|
- Makers and product builders who need custom symbols, footprints, or boards without spending hours in the GUI
|
||||||
|
- Anyone who wants AI to handle the repetitive EDA work
|
||||||
|
|
||||||
|
### 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.
|
||||||
|
|
||||||
|
### Zielgruppe
|
||||||
|
|
||||||
|
- Gelegenheits-Designer mit Elektronik-Kenntnissen, die mit KiCAD-Werkzeugen kämpfen
|
||||||
|
- Maker und Produktentwickler, die eigene Symbole, Footprints oder Platinen brauchen — ohne stundenlange GUI-Arbeit
|
||||||
|
- Alle, die repetitive EDA-Aufgaben an KI abgeben möchten
|
||||||
|
|
||||||
|
### 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.
|
||||||
1720
resources/images/KiCAD-MCP-Server.svg
Normal file
1720
resources/images/KiCAD-MCP-Server.svg
Normal file
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 101 KiB |
1612
resources/images/KiCAD-MCP-Server_only_css.svg
Normal file
1612
resources/images/KiCAD-MCP-Server_only_css.svg
Normal file
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 98 KiB |
Reference in New Issue
Block a user