+
+---
+
+## 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.
diff --git a/resources/images/KiCAD-MCP-Server.svg b/resources/images/KiCAD-MCP-Server.svg
new file mode 100644
index 0000000..f169aab
--- /dev/null
+++ b/resources/images/KiCAD-MCP-Server.svg
@@ -0,0 +1,1720 @@
+
+
diff --git a/resources/images/KiCAD-MCP-Server_only_css.svg b/resources/images/KiCAD-MCP-Server_only_css.svg
new file mode 100644
index 0000000..4565199
--- /dev/null
+++ b/resources/images/KiCAD-MCP-Server_only_css.svg
@@ -0,0 +1,1612 @@
+
+