10分钟上手KiCAD MCP Server10条实用提示词让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-ServerKiCAD MCP Server是一个把开源PCB设计软件 KiCad 与 Claude 等 AI 助手连起来的免费 MCP模型上下文协议桥接服务用自然语言描述电路需求AI 就能自动完成创建项目、放置元件、连线、设计规则检查和导出 Gerber 文件。本文将带你用10分钟完成安装配置并附赠10条可以直接复制使用的实用提示词模板。什么是 KiCAD MCP ServerMCPModel Context Protocol是 AI 客户端连接外部工具的标准协议。KiCAD MCP Server 把这个协议翻译成了 244 个 PCB 设计工具覆盖从原理图到生产文件的完整流程核心能力说明 244 个工具项目、原理图、PCB、布线、导出全覆盖 关键词检索184 个工具按 17 个分类索引AI 自动查找无需记忆工具名 完整设计流原理图 → 网表 → 自动布局 → 自动布线 → DRC → Gerber 跨平台Linux / Windows / macOS 均支持想查看全部工具清单可查阅 docs/TOOL_INVENTORY.md。准备工作3个必需组件2分钟开始安装前确认电脑上具备以下环境KiCad 9.0 或更高版本需包含 Python 的pcbnew模块官方安装包默认包含Node.js 18与Python 3.9Python 通常随 KiCad 自带一个支持 MCP 的 AI 客户端Claude Desktop、Claude Code、ClineVSCode、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-packagesWindowsC:\Program Files\KiCad\10.0\lib\python3\dist-packagesmacOSKiCad 自带 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添加丝印文字在顶层丝印层 x25mm、y45mm 位置添加文字 LED Controller v1.0。提示词 3批量放置元件在 x10mm、y10mm 放置一个 LED封装用 LED_SMD:LED_0805_2012Metric。再在 x20mm、y20mm 起创建 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 pcbnewPYTHONPATH指向错误改到 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），仅供参考