从想法到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-Server

KiCAD 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 会自动挑选并调用对应工具。

一键安装：三步装好环境

前置条件清单

组件	版本要求
KiCAD	9.0 及以上（含 pcbnew Python 模块）
Node.js	18 及以上
Python	3.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.md，Windows 遇到问题可查阅 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_file`	SMT 贴片生产
3D 模型	`export_3d`	STEP/STL 预览结构

把 Gerber 导出到 fabrication 文件夹，同时导出 CSV 格式的 BOM 和坐标文件。

导出逻辑实现于 python/commands/export.py，27 个导出工具覆盖 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 Server，AI 的修改可实时显示在界面中，详见 docs/IPC_BACKEND_STATUS.md