从想法到Gerber文件用KiCAD MCP Server完成端到端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 是一款基于模型上下文协议Model Context Protocol, MCP的开源服务器它能让 Claude 等 AI 助手直接用自然语言操作 KiCAD完成从原理图设计、PCB 布局布线到导出 Gerber 生产文件的完整 PCB 设计流程。本文面向零基础读者带你用 6 个步骤走通一条想法 → Gerber的端到端设计流水线。为什么选择 KiCAD MCP Server传统 PCB 设计的每一步都要在 KiCAD 图形界面里手动点击放置元件、画导线、同步到 PCB、手动铺铜、跑 DRC、导出 Gerber……对新手来说门槛很高。KiCAD MCP Server 把这一切变成了说人话244 个设计工具涵盖项目管理、原理图、PCB 布局、布线、DRC、导出等 17 大类约 10000 个标准符号动态符号加载无需配置即可调用 KiCAD 全部官方库关键词工具发现AI 能通过search_tools自动找到该用的工具不用你记工具名生产文件全家桶Gerber、钻孔文件、BOM 物料清单、拼板坐标Pick Place、3D 模型一键导出跨平台支持 Linux、Windows、macOS 你不需要背任何命令只要描述我想做什么AI 会自动挑选并调用对应工具。一键安装三步装好环境前置条件清单组件版本要求KiCAD9.0 及以上含 pcbnew Python 模块Node.js18 及以上Python3.9 及以上KiCAD 自带版本即可MCP 客户端Claude Desktop / Cline / OpenCode 任选其一Linux 安装步骤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一行命令验证 KiCAD 的 Python 环境是否就绪python3 -c import pcbnew; print(pcbnew.GetBuildVersion())Windows / macOS 安装Windows克隆仓库后直接运行 setup-windows.ps1脚本会自动检测 KiCAD 安装位置、安装依赖、构建项目并生成配置macOS使用 KiCAD 自带 Python 创建虚拟环境再运行 setup-macos.sh 自动生成客户端配置--apply模式详细的分平台说明见 docs/PLATFORM_GUIDE.mdWindows 遇到问题可查阅 docs/WINDOWS_TROUBLESHOOTING.md。客户端配置让 AI 连上 KiCAD配置的核心是告诉 MCP 客户端用 node 运行dist/index.js并指定 KiCAD 的 Python 路径。仓库里提供了现成模板config/claude-desktop-config.json — Claude Desktop 配置模板config/vscode-mcp.example.json — VS Code / GitHub Copilot 模板复制到.vscode/mcp.json即可被自动识别config/opencode.json — OpenCode 模板Linux 下服务器还能自动探测KiCAD 的 Python 位置大多数标准安装无需手动设置PYTHONPATH。配置完成后重启客户端让 AI 说一句运行check_kicad_ui能正常响应就说明链路通了。完整的配置指南见 docs/CLIENT_CONFIGURATION.md。端到端 PCB 设计流程6 步走通整个流程与 docs/PCB_DESIGN_WORKFLOW.md 中官方推荐的五阶段工作流一一对应项目创建 → 原理图设计 → PCB 布局布线 → 规则验证 → 生产文件输出以下示例以一个LED 驱动小板为例每一步都是直接对 AI 说的自然语言。第 1 步创建项目与板框直接告诉 AI新建一个名为 LEDBoard 的 KiCAD 项目板子尺寸 50mm × 50mm加矩形板框四角各加一个直径 3mm 的安装孔。AI 会自动调用create_project同时生成.kicad_pro、.kicad_pcb、.kicad_sch三个文件、set_board_size、add_board_outline和add_mounting_hole工具。项目文件的读写逻辑位于 python/commands/project.py板框操作位于 python/commands/board/outline.py。第 2 步原理图设计——放元件、连导线放置元件动态符号加载约 10000 个标准符号任选在原理图上放置一个 Device 库的 LED坐标 100,50、一个 1K 电阻、一个两针 Connector_Generic 接插件。连接网络把 R1 的 2 脚连到 LED1 的 1 脚在 J1 的 1 脚打 VCC 网络标签LED1 的 2 脚接到 GND。自动编号与电气检查给原理图自动编号然后跑一次 ERC 电气规则检查。对应工具链add_schematic_component、add_schematic_wire、add_schematic_net_label、connect_to_net、annotate_schematic、run_erc。想查看全部 65 个原理图工具的用法参考 docs/SCHEMATIC_TOOLS_REFERENCE.md。小技巧随时可以让 AI把原理图渲染成图片给我看get_schematic_view确认电路没问题再进入下一步。第 3 步一键同步原理图到 PCB把原理图同步到 PCB。一条指令AI 调用sync_schematic_to_board完成 KiCAD 中F8等价的操作所有元件封装和网络分配自动导入 PCB。这个工具实现了 python/commands/schematic.py 中的同步逻辑支持按符号 UUID 精确匹配多单元器件也不会张冠李戴。第 4 步PCB 布局与布线元件布局把 R1 移到 (15, 25)LED1 移到 (25, 25)所有电阻水平对齐。手动布线推荐用焊盘到焊盘模式自动找焊盘坐标、自动插过孔以 0.3mm 线宽从 R1 的 2 脚布一条线到 LED1 的 1 脚。铺地与铜皮在底层加一个覆盖整块的 GND 铜皮。如果网络较多还可以让 Freerouting 自动布线支持 Java / Docker / Podman 三种运行方式检查 Freerouting 是否可用然后对当前板子执行自动布线。布线工具的完整参数见 docs/ROUTING_TOOLS_REFERENCE.md自动布线环境搭建见 docs/FREEROUTING_GUIDE.md。第 5 步DRC 设计规则验证设置 0.15mm 最小间距、0.2mm 最小线宽然后运行 DRC把违例列表给我。AI 依次调用set_design_rules、run_drc、get_drc_violations你可以让 AI 逐条解释违例原因并自动修复。另外两个实用工具get_board_2d_view—— 生成 PCB 预览图直观检查布局snapshot_project—— 保存命名快照到snapshots/目录随时回滚到布线完成等检查点第 6 步导出 Gerber 与生产文件一切验证通过后生产文件一次备齐产出物工具用途Gerber 文件export_gerber板厂制造核心文件钻孔文件export_drill机械钻孔BOM 物料清单export_bom采购支持 CSV/XML/HTML/JSON坐标文件export_position_fileSMT 贴片生产3D 模型export_3dSTEP/STL 预览结构把 Gerber 导出到 fabrication 文件夹同时导出 CSV 格式的 BOM 和坐标文件。导出逻辑实现于 python/commands/export.py27 个导出工具覆盖 Gerber、IPC-2581、ODB、PDF、SVG 等几乎所有交付格式。至此一份可直接发给板厂的制造包就齐了——这就是端到端的完整流程 ✅进阶玩法让 AI 帮你省钱、省时间用 JLCPCB 250 万 元件库选料KiCAD MCP Server 内置嘉立创JLCPCB元件目录集成支持按封装、参数、价格、库存筛选并智能推荐更便宜的替代料Basic 元件免贴片费能省不少在 JLCPCB 里找 0603 封装的 10K 电阻只要 Basic 库给我库存充足的最便宜选项。首次使用可让 AI 执行download_jlcpcb_database建立本地库一次性约 40~60 分钟。详细用法见 docs/JLCPCB_USAGE_GUIDE.md。自定义封装与符号库里没有的元件直接说创建一个 4 引脚 SOT-23 的自定义封装再创建一个 8 引脚的 XYZ 芯片符号并把自定义库注册到项目。create_footprint、create_symbol等 15 个工具覆盖了从零建库的完整链路指南见 docs/FOOTPRINT_SYMBOL_CREATOR_GUIDE.md。其他值得了解的能力数据手册补全enrich_datasheets通过 LCSC 料号自动填充数据手册 URL跨工具迁移import_eagle_project可把 Eagle 项目转成 KiCAD 格式工具导航不确定 AI 有什么工具时问一句列出所有导出类工具即可只读资源23 个kicad://资源可直接查询项目状态元件列表、网络、层叠、DRC 报告不执行任何修改新手避坑清单先原理图后 PCB永远先完成原理图并通过 ERC再同步到 PCB多保存、多快照大改动后执行save_project关键节点用snapshot_project存档优先用route_pad_to_pad比手动指定 XY 坐标布线更快更可靠还支持自动过孔路径用绝对路径给 AI 的文件路径必须是绝对路径出错先看日志日志位于~/.kicad-mcp/logs/每进程一个文件排障时把日志发给 AI 让它帮你分析KiCAD GUI 实时联动实验性在 KiCAD 中启用 Preferences → Plugins → Enable IPC API ServerAI 的修改可实时显示在界面中详见 docs/IPC_BACKEND_STATUS.md延伸阅读完整工具清单244 个工具逐一说明docs/TOOL_INVENTORY.md端到端工作流官方指南docs/PCB_DESIGN_WORKFLOW.md架构说明docs/ARCHITECTURE.md版本更新记录CHANGELOG.md从我想要一块 LED 驱动板到发给板厂的 Gerber 压缩包KiCAD MCP Server 让你只需描述目标AI 负责执行。现在就可以打开你的 MCP 客户端说出第一句话新建一个 KiCAD 项目。【免费下载链接】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），仅供参考 从想法到Gerber文件：用KiCAD MCP Server完成端到端PCB设计流程的完整教程
从想法到Gerber文件用KiCAD MCP Server完成端到端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 是一款基于模型上下文协议Model Context Protocol, MCP的开源服务器它能让 Claude 等 AI 助手直接用自然语言操作 KiCAD完成从原理图设计、PCB 布局布线到导出 Gerber 生产文件的完整 PCB 设计流程。本文面向零基础读者带你用 6 个步骤走通一条想法 → Gerber的端到端设计流水线。为什么选择 KiCAD MCP Server传统 PCB 设计的每一步都要在 KiCAD 图形界面里手动点击放置元件、画导线、同步到 PCB、手动铺铜、跑 DRC、导出 Gerber……对新手来说门槛很高。KiCAD MCP Server 把这一切变成了说人话244 个设计工具涵盖项目管理、原理图、PCB 布局、布线、DRC、导出等 17 大类约 10000 个标准符号动态符号加载无需配置即可调用 KiCAD 全部官方库关键词工具发现AI 能通过search_tools自动找到该用的工具不用你记工具名生产文件全家桶Gerber、钻孔文件、BOM 物料清单、拼板坐标Pick Place、3D 模型一键导出跨平台支持 Linux、Windows、macOS 你不需要背任何命令只要描述我想做什么AI 会自动挑选并调用对应工具。一键安装三步装好环境前置条件清单组件版本要求KiCAD9.0 及以上含 pcbnew Python 模块Node.js18 及以上Python3.9 及以上KiCAD 自带版本即可MCP 客户端Claude Desktop / Cline / OpenCode 任选其一Linux 安装步骤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一行命令验证 KiCAD 的 Python 环境是否就绪python3 -c import pcbnew; print(pcbnew.GetBuildVersion())Windows / macOS 安装Windows克隆仓库后直接运行 setup-windows.ps1脚本会自动检测 KiCAD 安装位置、安装依赖、构建项目并生成配置macOS使用 KiCAD 自带 Python 创建虚拟环境再运行 setup-macos.sh 自动生成客户端配置--apply模式详细的分平台说明见 docs/PLATFORM_GUIDE.mdWindows 遇到问题可查阅 docs/WINDOWS_TROUBLESHOOTING.md。客户端配置让 AI 连上 KiCAD配置的核心是告诉 MCP 客户端用 node 运行dist/index.js并指定 KiCAD 的 Python 路径。仓库里提供了现成模板config/claude-desktop-config.json — Claude Desktop 配置模板config/vscode-mcp.example.json — VS Code / GitHub Copilot 模板复制到.vscode/mcp.json即可被自动识别config/opencode.json — OpenCode 模板Linux 下服务器还能自动探测KiCAD 的 Python 位置大多数标准安装无需手动设置PYTHONPATH。配置完成后重启客户端让 AI 说一句运行check_kicad_ui能正常响应就说明链路通了。完整的配置指南见 docs/CLIENT_CONFIGURATION.md。端到端 PCB 设计流程6 步走通整个流程与 docs/PCB_DESIGN_WORKFLOW.md 中官方推荐的五阶段工作流一一对应项目创建 → 原理图设计 → PCB 布局布线 → 规则验证 → 生产文件输出以下示例以一个LED 驱动小板为例每一步都是直接对 AI 说的自然语言。第 1 步创建项目与板框直接告诉 AI新建一个名为 LEDBoard 的 KiCAD 项目板子尺寸 50mm × 50mm加矩形板框四角各加一个直径 3mm 的安装孔。AI 会自动调用create_project同时生成.kicad_pro、.kicad_pcb、.kicad_sch三个文件、set_board_size、add_board_outline和add_mounting_hole工具。项目文件的读写逻辑位于 python/commands/project.py板框操作位于 python/commands/board/outline.py。第 2 步原理图设计——放元件、连导线放置元件动态符号加载约 10000 个标准符号任选在原理图上放置一个 Device 库的 LED坐标 100,50、一个 1K 电阻、一个两针 Connector_Generic 接插件。连接网络把 R1 的 2 脚连到 LED1 的 1 脚在 J1 的 1 脚打 VCC 网络标签LED1 的 2 脚接到 GND。自动编号与电气检查给原理图自动编号然后跑一次 ERC 电气规则检查。对应工具链add_schematic_component、add_schematic_wire、add_schematic_net_label、connect_to_net、annotate_schematic、run_erc。想查看全部 65 个原理图工具的用法参考 docs/SCHEMATIC_TOOLS_REFERENCE.md。小技巧随时可以让 AI把原理图渲染成图片给我看get_schematic_view确认电路没问题再进入下一步。第 3 步一键同步原理图到 PCB把原理图同步到 PCB。一条指令AI 调用sync_schematic_to_board完成 KiCAD 中F8等价的操作所有元件封装和网络分配自动导入 PCB。这个工具实现了 python/commands/schematic.py 中的同步逻辑支持按符号 UUID 精确匹配多单元器件也不会张冠李戴。第 4 步PCB 布局与布线元件布局把 R1 移到 (15, 25)LED1 移到 (25, 25)所有电阻水平对齐。手动布线推荐用焊盘到焊盘模式自动找焊盘坐标、自动插过孔以 0.3mm 线宽从 R1 的 2 脚布一条线到 LED1 的 1 脚。铺地与铜皮在底层加一个覆盖整块的 GND 铜皮。如果网络较多还可以让 Freerouting 自动布线支持 Java / Docker / Podman 三种运行方式检查 Freerouting 是否可用然后对当前板子执行自动布线。布线工具的完整参数见 docs/ROUTING_TOOLS_REFERENCE.md自动布线环境搭建见 docs/FREEROUTING_GUIDE.md。第 5 步DRC 设计规则验证设置 0.15mm 最小间距、0.2mm 最小线宽然后运行 DRC把违例列表给我。AI 依次调用set_design_rules、run_drc、get_drc_violations你可以让 AI 逐条解释违例原因并自动修复。另外两个实用工具get_board_2d_view—— 生成 PCB 预览图直观检查布局snapshot_project—— 保存命名快照到snapshots/目录随时回滚到布线完成等检查点第 6 步导出 Gerber 与生产文件一切验证通过后生产文件一次备齐产出物工具用途Gerber 文件export_gerber板厂制造核心文件钻孔文件export_drill机械钻孔BOM 物料清单export_bom采购支持 CSV/XML/HTML/JSON坐标文件export_position_fileSMT 贴片生产3D 模型export_3dSTEP/STL 预览结构把 Gerber 导出到 fabrication 文件夹同时导出 CSV 格式的 BOM 和坐标文件。导出逻辑实现于 python/commands/export.py27 个导出工具覆盖 Gerber、IPC-2581、ODB、PDF、SVG 等几乎所有交付格式。至此一份可直接发给板厂的制造包就齐了——这就是端到端的完整流程 ✅进阶玩法让 AI 帮你省钱、省时间用 JLCPCB 250 万 元件库选料KiCAD MCP Server 内置嘉立创JLCPCB元件目录集成支持按封装、参数、价格、库存筛选并智能推荐更便宜的替代料Basic 元件免贴片费能省不少在 JLCPCB 里找 0603 封装的 10K 电阻只要 Basic 库给我库存充足的最便宜选项。首次使用可让 AI 执行download_jlcpcb_database建立本地库一次性约 40~60 分钟。详细用法见 docs/JLCPCB_USAGE_GUIDE.md。自定义封装与符号库里没有的元件直接说创建一个 4 引脚 SOT-23 的自定义封装再创建一个 8 引脚的 XYZ 芯片符号并把自定义库注册到项目。create_footprint、create_symbol等 15 个工具覆盖了从零建库的完整链路指南见 docs/FOOTPRINT_SYMBOL_CREATOR_GUIDE.md。其他值得了解的能力数据手册补全enrich_datasheets通过 LCSC 料号自动填充数据手册 URL跨工具迁移import_eagle_project可把 Eagle 项目转成 KiCAD 格式工具导航不确定 AI 有什么工具时问一句列出所有导出类工具即可只读资源23 个kicad://资源可直接查询项目状态元件列表、网络、层叠、DRC 报告不执行任何修改新手避坑清单先原理图后 PCB永远先完成原理图并通过 ERC再同步到 PCB多保存、多快照大改动后执行save_project关键节点用snapshot_project存档优先用route_pad_to_pad比手动指定 XY 坐标布线更快更可靠还支持自动过孔路径用绝对路径给 AI 的文件路径必须是绝对路径出错先看日志日志位于~/.kicad-mcp/logs/每进程一个文件排障时把日志发给 AI 让它帮你分析KiCAD GUI 实时联动实验性在 KiCAD 中启用 Preferences → Plugins → Enable IPC API ServerAI 的修改可实时显示在界面中详见 docs/IPC_BACKEND_STATUS.md延伸阅读完整工具清单244 个工具逐一说明docs/TOOL_INVENTORY.md端到端工作流官方指南docs/PCB_DESIGN_WORKFLOW.md架构说明docs/ARCHITECTURE.md版本更新记录CHANGELOG.md从我想要一块 LED 驱动板到发给板厂的 Gerber 压缩包KiCAD MCP Server 让你只需描述目标AI 负责执行。现在就可以打开你的 MCP 客户端说出第一句话新建一个 KiCAD 项目。【免费下载链接】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），仅供参考