Files
kicad-mcp-server/.github/README.md

8.8 KiB
Raw Blame History


English

KiCAD MCP Server is a Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with KiCAD for PCB design automation. Built on the MCP 2025-06-18 specification, this server provides comprehensive tool schemas and real-time project state access for intelligent PCB design workflows.

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.

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+
  2. Install Node.js 18+ and Python 3.11+
  3. Clone and build:
git clone https://github.com/mixelpixx/KiCAD-MCP-Server.git
cd KiCAD-MCP-Server
npm install
npm run build
  1. Configure Claude Desktop — see Platform Guide

Documentation

Community

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 (MCP) Server, der KI-Assistenten wie Claude ermöglicht, mit KiCAD für die PCB-Design-Automatisierung zu interagieren. Aufgebaut auf der MCP-Spezifikation 2025-06-18, bietet dieser Server umfassende Tool-Schemas und Echtzeit-Projektzugriff für intelligente PCB-Design-Workflows.

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.

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+ installieren
  2. Node.js 18+ und Python 3.11+ installieren
  3. Klonen und bauen:
git clone https://github.com/mixelpixx/KiCAD-MCP-Server.git
cd KiCAD-MCP-Server
npm install
npm run build
  1. Claude Desktop konfigurieren — siehe Plattform-Anleitung

Dokumentation

Community

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.


中文

KiCAD MCP Server 是一个模型上下文协议MCP服务器使 Claude 等 AI 助手能够与 KiCAD 交互,实现 PCB 设计自动化。本服务器基于 MCP 2025-06-18 规范构建,为智能 PCB 设计工作流提供全面的工具模式和实时项目状态访问。

用自然语言设计 PCB

描述你想构建的内容 — 让 AI 处理 EDA 工作。放置元件、创建自定义符号和封装、布线、运行检查并导出生产文件 — 全程通过与 AI 助手对话完成。

当前功能

  • 项目创建、原理图编辑、元件放置、布线、DRC/ERC、导出
  • 自定义符号和封装生成 — 适用于标准 KiCAD 库中未收录的模块
  • 个人库管理 — 一次创建,跨项目复用
  • JLCPCB 集成 — 包含价格和库存数据的元件目录
  • Freerouting 集成 — 通过 Java/Docker 实现自动 PCB 布线
  • 可视化反馈 — 快照和会话日志,便于追溯
  • 跨平台 — Windows、Linux、macOS

快速开始

  1. 安装 KiCAD 9.0+
  2. 安装 Node.js 18+Python 3.11+
  3. 克隆并构建:
git clone https://github.com/mixelpixx/KiCAD-MCP-Server.git
cd KiCAD-MCP-Server
npm install
npm run build
  1. 配置 Claude Desktop — 参见 平台指南

文档

社区

AI 声明

借助 AI 辅助开发
本项目在 AI 辅助编码工具GitHub Copilot、Claude的支持下开发完成。
所有代码均经过维护者的审查、测试和集成。
AI 工具用于加速开发 — 创意决策、架构设计和责任归属完全由作者承担。