JinDaGe - KiCAD PCB Designer MCP Details

article

README

🚀 KiCAD MCP 使用指南

KiCAD MCP（Microcontroller Protocol）是一个基于 Node.js 和 Python 的接口协议，旨在实现 PCB 设计自动化。用户可通过发送 JSON 命令，轻松控制 KiCAD 进行各类操作。

🚀 快速开始

KiCAD MCP 能让你借助 JSON 命令控制 KiCAD 实现 PCB 设计自动化。以下为你介绍使用前的安装配置步骤。

📦 安装指南

环境要求

Node.js 版本 >= v18.x.x
KiCAD 9.0 或更高版本
具有 Python 支持的 KiCAD 安装

配置步骤

克隆项目仓库：

git clone https://github.com/your-repository/kicad-mcp.git
cd kicad-mcp

安装依赖：
```
npm install
```
启动服务：
```
npm run build && npm start
```

✨ 主要特性

项目管理

可新建、打开和保存 KiCAD 项目。
能管理项目配置文件。
支持获取项目元数据。

PCB 设计

可设置电路板尺寸与单位。
能添加自定义边框（矩形、圆角矩形、圆形等）。
可创建和管理图层。
支持添加固定孔、文本注释等功能。

元件操作

能放置元件并指定封装类型。
可创建元件数组（网格或圆形布局）。
能调整元件位置、旋转参数。
支持对齐和分布元件。
可复制元件并修改属性。

信号布线

能创建并管理网络。
支持自动或手动绘制走线。
可添加过孔（盲孔、埋孔等）。
能布置差分对线对。
可创建铜皮（电源地平面）。

设计规则检查

可设置全局设计规范（间距、线宽等）。
能定义网络类别的特殊规则。
支持执行 DRC 检查。
可管理违规列表。

输出文件

能生成 Gerber 文件。
可导出 PDF 文档。
能创建 SVG 图形。
可生成 3D 模型。
能制作 BOM 清单。

🔧 技术细节

项目采用分层架构设计，具体如下：

Node.js MCP 服务器

kicad-server.ts：实现 MCP 协议的核心服务。
使用 STDIO 传输协议。
管理 Python 进程。
处理命令队列和错误恢复。

Python 接口

kicad_interface.py：主要功能包括：
- 解析从标准输入接收的 JSON 命令。
- 将指令转发给专用处理器。
- 返回 JSON 格式的结果。
- 优雅处理各类错误。
按模块划分的功能组件：
- commands/project.py：处理项目创建、打开、保存等操作。
- commands/board/：包含多个功能子模块：
  - size.py：管理电路板尺寸。
  - layers.py：控制图层配置。
  - outline.py：添加边框。
  - view.py：可视化显示。
- commands/component.py：处理元件的放置与编辑。
- commands/routing.py：实现走线功能。
- commands/design_rules.py：管理设计规则检查。
- commands/export.py：输出不同格式的文件。

这种架构确保了每个 PCB 设计环节都有专门模块负责，同时保持接口的一致性和简洁性。

📚 详细文档

常见问题与解决方案

问题 1：KiCAD MCP 未在 Claude 工具中显示

确保重启 VSCode 后，Cline MCP 设置已生效。
检查配置文件中的路径是否正确无误。
确认npm run build命令执行成功。

问题 2：启动服务失败

检查 Node.js 版本是否符合要求。
确保 KiCAD 安装了 Python 支持。
查看控制台输出的错误信息。

项目贡献

欢迎提交 Pull Request，帮助改进本项目！ Contributing Guidelines

📄 许可证

MIT License

KiCAD PCB Designer