3步看懂AI辅助PCB设计:KiCAD MCP Server项目概览与244个工具全景地图
【免费下载链接】KiCAD-MCP-ServerKiCAD MCP is a Model Context Protocol (MCP) implementation that enables Large Language Models (LLMs) like Claude to directly interact with KiCAD for printed circuit board design.项目地址: https://gitcode.com/gh_mirrors/ki/KiCAD-MCP-Server
KiCAD MCP Server是一个基于模型上下文协议(MCP)的开源服务器,让 Claude 等 AI 助手能够直接操作 KiCAD 进行电路板(PCB)设计:画原理图、布局元件、自动布线、导出 Gerber 文件——全部用一句自然语言完成。截至 v2.8.2,它已注册244 个工具,覆盖 17 大类别,支持 Linux、Windows 和 macOS。
不管你是想体验"AI 画板"的硬件新手,还是想自动化繁琐设计流程的工程师,本文只需 3 步,就能让你彻底看懂这个项目。
第1步:它是什么?——AI 与 KiCAD 之间的"翻译官" 🧠
核心原理一句话
AI 助手说人话 → MCP 协议翻译 → TypeScript 服务器接收 → Python 层调用 KiCAD 的 pcbnew API 真正干活。
整个系统分两层,架构清晰,官方文档 docs/ARCHITECTURE.md 中有完整说明:
| 层级 | 技术栈 | 职责 |
|---|---|---|
| 上层服务器 | TypeScript(src/) | 实现 MCP 协议、注册工具、校验参数、管理 Python 子进程 |
| 底层接口 | Python(python/) | 通过 pcbnew SWIG 或 KiCAD IPC API 执行真正的板级/原理图操作 |
关键入口文件:
- 工具注册与路由:src/tools/registry.ts、src/tools/router.ts
- Python 命令入口:python/kicad_interface.py
- 后端自动检测(SWIG / IPC 二选一):python/kicad_api/factory.py
对新手意味着什么?你不需要写任何 Python 或 C++,只要在 Claude Desktop、Claude Code、Cline 或 OpenCode 里连上这个服务器,就能用日常语言指挥 KiCAD。
第2步:如何安装?——最快上手配置方法 🚀
环境要求一览
| 软件 | 版本要求 | 说明 |
|---|---|---|
| KiCAD | 9.0+ | 需包含 pcbnew Python 模块 |
| Node.js | 18+ | 运行 MCP 服务器 |
| Python | 3.9+ | KiCAD 自带版本即可(推荐) |
| MCP 客户端 | 任意 | Claude Desktop / Claude Code / Cline / OpenCode |
三种平台最快路径 📦
Linux(Ubuntu/Debian,主力平台,测试最充分):
git clone --branch stable https://gitcode.com/gh_mirrors/ki/KiCAD-MCP-Server cd KiCAD-MCP-Server npm install && pip3 install -r requirements.txt && npm run buildWindows 10/11(推荐自动脚本):
.\setup-windows.ps1脚本会自动检测 KiCAD 安装、验证前置条件、装依赖、构建并生成配置,详见 setup-windows.ps1。
macOS(实验性支持):
./setup-macos.sh --apply脚本会解析 KiCAD 内置 Python 环境并生成 Claude Desktop 配置,详细说明见 setup-macos.sh。
连接你的 AI 客户端
仓库的 config/ 目录提供了主流客户端的现成配置示例:
- Claude Desktop:config/claude-desktop-config.json
- VS Code:config/vscode-mcp.example.json
- Linux / macOS / Windows 示例:config/linux-config.example.json、config/macos-config.example.json、config/windows-config.example.json
配置方法完整指南见 docs/CLIENT_CONFIGURATION.md,平台差异细节见 docs/PLATFORM_GUIDE.md。
第3步:244个工具全景地图——AI 能替你做什么?🗺️
完整清单由脚本自动生成并随版本更新,收录在 docs/TOOL_INVENTORY.md(v2.8.2 快照),其中184 个工具已建立关键词索引,可通过search_tools按关键字发现。下面是按功能分组的"能力地图":
📂 项目与板级管理(31 个)
create_project、open_project、save_project、set_board_size、add_board_outline、add_mounting_hole、get_board_2d_view……从"新建项目"到"画板框、打安装孔"一气呵成,源码在 src/tools/project.ts 与 src/tools/board.ts。
🔧 元件布局(28 个)
place_component、move_component、batch_move_components、align_components、suggest_placement(智能布局建议)、hierarchical_place(按原理图层级聚类摆放)……这是数量最大的类目之一,见 src/tools/component.ts。
⚡ 布线与自动布线(21 个)
手动:route_trace、add_via、route_differential_pair(差分对)、add_copper_pour(铺铜); 自动:集成Freerouting自动布线器(Java / Docker / Podman 均可运行),一条autoroute命令跑完全板。用法详解见 docs/FREEROUTING_GUIDE.md。
📐 原理图全流程(65 个,最大类目)
从create_schematic到annotate_schematic(自动编号)、sync_schematic_to_board(F8 同步)、run_erc(电气规则检查),还包含批量操作(src/tools/schematic-batch.ts)、层次化子图(src/tools/schematic-hierarchy.ts)与布局整理(src/tools/schematic-layout.ts)。约 1 万个动态符号库开箱可用。
📤 导出与生产输出(27 个)
Gerber、ODB++、IPC-2581、BOM(CSV/XML/HTML/JSON)、网表、3D 模型(STEP/STL)、坐标文件(贴片用)……交板生产所需格式几乎全覆盖,见 src/tools/export.ts。
🏭 元器件采购与生态集成(18 个)
- JLCPCB 嘉立创:250 万+ 元件目录,可下载本地 SQLite 库做离线搜索、查库存价格、找更便宜的替代料(docs/JLCPCB_USAGE_GUIDE.md)
- Digi-Key:按料号/参数搜索、库存与生命周期检查
- LCSC 数据手册:自动补全元件手册链接
- Eagle / Altium / PADS 等导入:
import_eagle_project、import_pcb跨平台迁移设计 - GUI 驱动(实验性):11 个工具可直接驱动 KiCAD 图形界面的菜单与对话框
✅ 设计与质量保障(9 个+)
run_drc(设计规则检查)、set_design_rules、validate_schematic、validate_symbol_library(精确定位到行/列的结构错误)、check_placement_clearance(间距冲突分类)。
🔍 工具发现(3 个,强烈推荐新手用)
面对 244 个工具别慌——list_tool_categories浏览分类、search_tools按关键词查找、get_category_tools查看某类全部工具,AI 助手会自己调用它们。
新手实战:一句自然语言的威力 💬
README 中给出的典型工作流,可以直接"抄作业":
"创建一个叫 LEDBoard 的新 KiCAD 项目,板子 50mm × 50mm,四角各放一个 3mm 安装孔,然后在每层铺 GND 铜皮,最后跑一次 DRC 并导出 Gerber。"
完整示例(元件放置、布线、自动布线、嘉立创选型)见 README.md 的 Usage Examples 一节。
常见问题与延伸阅读 📚
| 场景 | 去哪找答案 |
|---|---|
| 安装/环境问题 | docs/KNOWN_ISSUES.md、docs/WINDOWS_TROUBLESHOOTING.md |
| IPC 实时后端状态 | docs/IPC_BACKEND_STATUS.md |
| PCB 设计工作流 | docs/PCB_DESIGN_WORKFLOW.md |
| 原理图工具参考 | docs/SCHEMATIC_TOOLS_REFERENCE.md |
| 版本更新记录 | CHANGELOG.md |
| 路线图(即将推出什么) | docs/ROADMAP.md |
小提示:安装请始终克隆stable分支——它只在正式发布时更新,main分支可能包含尚未发布的修改。
写在最后
KiCAD MCP Server 把 KiCAD 的"鼠标操作"变成了"自然语言对话":244 个工具覆盖从建项、画原理图、布局布线到导出生产文件的完整闭环,再用search_tools让 AI 自己找到该用的工具。如果你还在手工点击 KiCAD 的每一个菜单,不妨按本文 3 步试一次——让 AI 帮你把板子跑完,也许只需要一段对话。
【免费下载链接】KiCAD-MCP-ServerKiCAD MCP is a Model Context Protocol (MCP) implementation that enables Large Language Models (LLMs) like Claude to directly interact with KiCAD for printed circuit board design.项目地址: https://gitcode.com/gh_mirrors/ki/KiCAD-MCP-Server
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考