☰
10分钟上手KiCAD MCP Server:10条实用提示词让AI替你完成第一块PCB板
2026/10/3 16:41:51 网站建设 项目流程

10分钟上手KiCAD MCP Server:10条实用提示词让AI替你完成第一块PCB板

【免费下载链接】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是一个把开源PCB设计软件 KiCad 与 Claude 等 AI 助手连起来的免费 MCP(模型上下文协议)桥接服务:用自然语言描述电路需求,AI 就能自动完成创建项目、放置元件、连线、设计规则检查和导出 Gerber 文件。本文将带你用10分钟完成安装配置,并附赠10条可以直接复制使用的实用提示词模板。

什么是 KiCAD MCP Server?

MCP(Model Context Protocol)是 AI 客户端连接外部工具的标准协议。KiCAD MCP Server 把这个协议"翻译"成了 244 个 PCB 设计工具,覆盖从原理图到生产文件的完整流程:

核心能力说明
🧩 244 个工具项目、原理图、PCB、布线、导出全覆盖
🔍 关键词检索184 个工具按 17 个分类索引,AI 自动查找,无需记忆工具名
📐 完整设计流原理图 → 网表 → 自动布局 → 自动布线 → DRC → Gerber
🌐 跨平台Linux / Windows / macOS 均支持

想查看全部工具清单,可查阅 docs/TOOL_INVENTORY.md。

准备工作:3个必需组件(2分钟)

开始安装前,确认电脑上具备以下环境:

  1. KiCad 9.0 或更高版本(需包含 Python 的pcbnew模块,官方安装包默认包含)
  2. Node.js 18+与Python 3.9+(Python 通常随 KiCad 自带)
  3. 一个支持 MCP 的 AI 客户端:Claude Desktop、Claude Code、Cline(VSCode)、VS Code Copilot 或 OpenCode

一键安装步骤:克隆构建只需3行命令(3分钟)

Linux / macOS 用户:

git clone --branch stable https://gitcode.com/gh_mirrors/ki/KiCAD-MCP-Server.git cd KiCAD-MCP-Server npm install && pip3 install -r requirements.txt && npm run build

⚠️ 注意使用stable分支,它只包含已发布的稳定版本;main分支可能含有未发布的修复。

Windows 用户更省事——克隆后只需运行一键脚本:

.\setup-windows.ps1

脚本会自动检测 KiCad 安装位置、安装依赖、构建项目并生成配置。macOS 用户也可使用 setup-macos.sh 自动生成 Claude Desktop 的 MCP 配置(支持--verify校验、--dry-run预览、--apply写入)。

最快配置方法:3步接入 AI 客户端(2分钟)

第 1 步:打开你客户端的 MCP 配置文件(Claude Desktop 为例,模板见 config/claude-desktop-config.json):

{ "mcpServers": { "kicad": { "command": "node", "args": ["/path/to/KiCAD-MCP-Server/dist/index.js"], "env": { "PYTHONPATH": "/usr/lib/kicad/lib/python3/dist-packages", "LOG_LEVEL": "info" } } } }

第 2 步:把args中的路径替换为你克隆目录的绝对路径,PYTHONPATH按平台调整:

平台PYTHONPATH 参考值
Linux/usr/lib/kicad/lib/python3/dist-packages
WindowsC:\Program Files\KiCad\10.0\lib\python3\dist-packages
macOSKiCad 自带 Python 框架下的 site-packages

第 3 步:完全退出并重启客户端,然后用这句话验证连接:

使用 kicad MCP server 运行 check_kicad_ui。

AI 能正确返回 KiCad 环境状态,就说明接通了。各客户端的完整配置对照表见 docs/CLIENT_CONFIGURATION.md。

10条实用提示词:从建项目到投板文件

💡 小贴士:你不需要记住任何工具名——直接用自然语言描述意图即可,服务端会通过search_tools关键词索引自动找到对应工具。

提示词 1:创建项目 + 画板框

在文档文件夹新建一个名为 'LEDBoard' 的 KiCAD 项目。设置板子尺寸为 50mm x 50mm,添加矩形板框,并在四个角落各放一个 3mm 直径的安装孔,距边缘 3mm。

提示词 2:添加丝印文字

在顶层丝印层 x=25mm、y=45mm 位置添加文字 'LED Controller v1.0'。

提示词 3:批量放置元件

在 x=10mm、y=10mm 放置一个 LED,封装用 LED_SMD:LED_0805_2012Metric。再在 x=20mm、y=20mm 起创建 4 个电阻(R1-R4)的网格,间距 5mm。

✨ 没有明确布局想法时,直接说"根据连接关系建议一个元件布局"——suggest_placement工具会基于信号连接自动优化摆放位置。

提示词 4:搜索并放置原理图符号

在符号库里搜索 10kΩ 电阻和 LED 符号,把它们放到原理图上并连成串联电路。

服务端支持动态加载 KiCad 标准库中约 10,000 个符号,无需手动导入。原理图完整工具(放置、连线、网表、ERC)参考 docs/SCHEMATIC_TOOLS_REFERENCE.md。

提示词 5:连线与网络命名

创建名为 'LED1' 的网络,把 R1 的 2 脚连到 LED 阳极,电源端连到 VCC 网络。

提示词 6:原理图同步到 PCB

将原理图同步到 PCB,让网络名和引脚信息导入到板上。

对应sync_schematic_to_board工具,相当于 KiCad 里的 F8 一键更新。

提示词 7:一键自动布线

检查 Freerouting 是否就绪,然后用 Freerouting 对当前板子执行自动布线,超时 5 分钟。

autoroute工具会自动完成 DSN 导出 → 跑布线引擎 → 导入结果的完整流程,支持 Java 或 Docker 运行环境。详细配置见 docs/FREEROUTING_GUIDE.md。

提示词 8:设计规则检查(DRC)

设置 0.15mm 间距、0.2mm 最小线宽的设计规则,然后运行 DRC 并把所有违规项列给我看。

提示词 9:选料与成本优化(JLCPCB)

搜索 0603 封装的 10k 电阻,只要 Basic 库元件,显示库存充足的最便宜选项。

连接 JLCPCB 250 万+ 元件库,可查实时价格与库存;Basic 元件在 JLCPCB 免贴片费,能显著降低打样成本。首次使用先说"下载 JLCPCB 元件数据库"完成一次性初始化。更多用法见 docs/JLCPCB_USAGE_GUIDE.md。

提示词 10:导出投板文件

导出 Gerber 文件、钻孔文件、BOM 和贴片坐标文件到 'fabrication' 文件夹。

完成后,这一套文件就能直接交给 PCB 打样/贴片厂了——你的第一块板就这么诞生了 🎉

进阶技巧:让 AI 用得更好

  • 📸实时看板:"给我看当前板子的预览图"——服务端会渲染整板 2D 视图
  • 💾快照检查点:"保存一个名为 after-drc 的快照"——试错前存档,随时回退
  • 🔍工具自助:"列出 routing 分类下的所有工具"——17 个分类任你浏览
  • 🧾视觉确认:"把原理图导出为 SVG"——AI 渲染出来给你人工复核

常见问题排查

症状解决方法
客户端里看不到 kicad 服务器确认dist/index.js已构建、配置用绝对路径,完全重启客户端
No module named 'pcbnew'PYTHONPATH指向错误,改到 KiCad 自带的 Python 目录
工具调用莫名失败查看日志~/.kicad-mcp/logs/下的服务器日志,确认已加载项目
Windows 启动失败运行.\setup-windows.ps1自动诊断,详见 docs/WINDOWS_TROUBLESHOOTING.md

下一步学什么

  • 完全不打开 GUI 的"无头"原理图设计实战:docs/HEADLESS_AUTHORING.md
  • 全部 244 个工具速查表:docs/TOOL_INVENTORY.md
  • 版本更新记录:CHANGELOG.md

【免费下载链接】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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询