内容
# KiCad MCP
[](LICENSE)
[](pyproject.toml)
[](https://docs.astral.sh/uv/)
[](https://github.com/jlowin/fastmcp)
**KiCad EDA 的 AI 助手** — 一个 MCP 服务器，允许 Claude（或任何大型语言模型）通过 KiCad 检查、设计和制造印刷电路板。
将其视为 **PCB 设计的副驾驶**：Claude 可以运行 DRC 检查、导出 Gerber 文件、搜索元件库、放置元件、布线和准备制造文件 — 所有这些都无需您触摸 KiCad 的 GUI。
[安装](INSTALL.md) · [工作原理](docs/HOW_IT_WORKS.md) · [工具目录](docs/TOOLS.md) · [架构](docs/ARCHITECTURE.md) · [API 参考](docs/API.md)
---
## 快速入门
```powershell
just bootstrap # 安装依赖
just serve # 在 11016 端口启动服务器
# 打开 http://localhost:11017 访问网页仪表盘
```
需要单独安装 [KiCad](https://www.kicad.org/download/) （稳定版 10.x 用于导出， 可选 11 nightly 用于实时板编辑）。
---
## 您可以用它做什么？
| 您询问 Claude... | 会发生什么 | 需要 GUI 吗？ |
|---|---|---|
| "对我的板运行 DRC" | `kicad-cli` 运行无界面，返回违规 | ❌ |
| "为 JLCPCB 导出 Gerber 文件" | 生成所有 Gerber + 钻孔文件，并压缩 | ❌ |
| "查找一个 SOIC-8 封装" | 搜索 KiCad 库，返回结果 | ❌ |
| "生成 BOM" | 解析原理图，输出 CSV/JSON | ❌ |
| "在 50mm、30mm 处放置一个 0.1uF 电容" | IPC 无界面修改板文件 | ❌ |
| "在这些焊盘之间布线" | IPC 无界面添加轨迹 | ❌ |
| "我的原理图上有什么？" | 读取网表，返回元件列表 | ❌ |
| "审核我的板是否有 DFM 问题" | AI 分析板，提出修复建议 | ❌ |
**大多数操作都在无界面下运行。** 只有在使用旧版 TCP 桥接模式（旧版 KiCad 版本的备用）时，KiCad 的 GUI 才会打开。参见 [工作原理](docs/HOW_IT_WORKS.md#headless-vs-gui)。
---
## 原理图 → 板流
KiCad 设计流程为：**原理图 → 封装 → 网表 → 板布局 → 导出**
每个步骤都有 MCP 工具来自动化：
| 步骤 | 会发生什么 | 工具 | 已自动化？ |
|------|-------------|------|------------|
| 1. 绘制原理图 | 放置符号，连接线路 | `sch_load`，KiCad GUI 手动 | 🟡 可视化工作 |
| 2. 分配封装 | 匹配每个符号到物理封装 | `lib_find_footprint` | ✅ |
| 3. 生成网表 | 创建连接图 | `sch_export_netlist` | ✅ |
| 4. 放置元件 | 在板上定位元件 | `pcb_place_component` | ✅（需要坐标） |
| 5. 布线 | 连接焊盘 | `pcb_add_track` | ✅（需要坐标） |
| 6. 验证 | 运行 DRC/ERC | `pcb_drc`，`sch_erc` | ✅ |
| 7. 导出 | 生成制造文件 | `pcb_export_gerber`，`pcb_export_step`，`bom_generate` | ✅ |
**创造性步骤**（原理图绘制，元件放置策略，布线拓扑）仍然受益于可视化的 KiCad GUI。MCP 服务器处理 **其他所有事情** — 验证，导出，库搜索和由 Claude 驱动的编程更改。
---
## 网页仪表盘
一个 React + Three.js 网页应用提供了一个 [板市场](docs/BOARD_MARKETPLACE.md)（浏览和下载 GitHub 上的 KiCad 项目），3D 板查看器，AI 聊天（PCB 设计副驾驶），制造管道与订单跟踪，设计审查与注释，以及参数化元件浏览器。在 `http://localhost:11017` 访问。
---
## 为什么选择 KiCad？
KiCad 是 **唯一** 具有完整无界面 CLI（`kicad-cli`）的 EDA 工具。Altium、Allegro 和 Eagle 没有等效工具。这使得 KiCad 独特地适用于 AI 驱动的自动化 — Claude 可以在不需要显示服务器或 GUI 许可证的情况下控制它。
---
## 目录
| 文档 | 内容 |
|----------|---------------|
| [INSTALL.md](INSTALL.md) | 安装 KiCad、依赖、配置 |
| [docs/HOW_IT_WORKS.md](docs/HOW_IT_WORKS.md) | 无界面 vs GUI，原理图→板流程，自动化级别 |
| [docs/BOARD_MARKETPLACE.md](docs/BOARD_MARKETPLACE.md) | 浏览和下载 GitHub 上的 KiCad 项目 |
| [docs/TOOLS.md](docs/TOOLS.md) | 所有 41 个 MCP 工具，按类别 |
| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | 代码结构，IPC vs TCP，生命周期 |
| [docs/API.md](docs/API.md) | REST + MCP API 参考 |
| [docs/NIGHTLY_HEADLESS.md](docs/NIGHTLY_HEADLESS.md) | 设置 KiCad 11 nightly 进行无界面 IPC |
| [docs/KICAD_API.md](docs/KICAD_API.md) | KiCad 脚本比较 |
## 许可证
MIT © 2026 Sandra Schipal
