5.1 KiB
KiCad MCP Pro 与 KiCadRoutingTools 协作
用户指定 PCB 设计过程中使用这两个工具。本文件规定分工和工程交接；路由参数的完整说明按需读取本机 kicad-routing-tools 技能。路径或版本变更时核实实际安装，不从旧记录推断能力。
遵守当前会话及适用 AGENTS.md 的工具执行约定：整个工作流无界面运行。只调用不会启动、附着或聚焦 KiCad GUI 的 MCP 方法；不能确认无界面时，改走 KiCad CLI、文件接口、脚本或 API。不得启动 GUI 来确认当前打开的工程、预览结果或执行检查；没有无界面替代方案时报告限制。
分工与入口
| 工具 | 用途 | 本机入口 |
|---|---|---|
| kicad-mcp-pro | 工程信息、原理图/PCB/规则/叠层核查；能力与授权允许时进行布局及局部编辑；原生检查、审核和制造输出 | 已注册的 mcp__kicad__… 工具；服务程序 D:\AI软件\kicad-mcp-pro\.venv\Scripts\kicad-mcp-pro.exe |
| KiCadRoutingTools | 网络检查、扇出、单端/差分布线、调长、覆铜相关操作、独立连通性与几何 DRC | D:\AI软件\codex-skills\kicad-routing-tools\scripts\krt.ps1 |
| KiCad 原生 CLI/API | 保存后原生回读、填铜与 DRC；两工具未覆盖的必要局部几何处理 | C:\Program Files\KiCad\10.0\bin\kicad-cli.exe；专用 pcbnew Python |
2026-09-14 实测 MCP 3.34.3、KiCad CLI/IPC 10.0.3，服务当时为只读模式；这是环境快照，不能作为以后写操作已启用的依据。调用 kicad_get_version、必要时 kicad_get_server_info 核查能力/模式；用 kicad_set_project 绑定已确认的 PCB/原理图路径，再取工程信息及 project_get_next_action。工具建议不能覆盖用户限定的阶段。发现的工具元数据、调用参数和运行时能力优先于静态工具清单。
2026-10-08 工程实测 KiCadRoutingTools 0.22.1，根目录 D:\AI软件\KiCadRoutingTools-0.22.1，专用 Python 为 D:\AI软件\kicad-routing-env\Scripts\pythonw.exe。这是本机快照，执行时仍检查实际路径、版本和 CLI 帮助；Windows 使用已验证的无窗口启动器及无窗口子进程配置，不只凭脚本名判断。运行时采用 KiCad Python 3.11 和正确路径，不混用不能加载 pcbnew 的 MCP Python 环境。命令使用绝对路径并对路径、网络通配符加引号；先读相应命令帮助。
同一工程的交接
- 对齐 MCP 绑定工程、磁盘 PCB 输入和同名
.kicad_pro/.kicad_dru；仅以明确确认的磁盘路径为准，不依赖或检查 GUI 当前打开的工程状态。 - 用
copy_board.py成套复制到独立候选路径，并确认自定义规则和库依赖齐全。修改限定于授权对象；固定布局任务禁止调用布局优化器移动器件。 - 对同一工程可能写入的 headless MCP、CLI 布线、填铜、DRC 和保存串行执行。外部文件更新后通过文件接口重新加载/绑定并读回确认，再做下一次编辑；禁止用进程内旧内存板覆盖磁盘新结果。
- 原生工具缺少某类操作时，可在独立副本用版本匹配的 API 或经验证的文件变换完成必要几何工作。保留两工具的工程核查和独立验收，不以自编脚本全面替代它们。
- 某工具或能力不可用时报告具体原因和未执行项，继续无依赖且获授权的工作；不能假称调用成功，也不能将缺失验收记为通过。
路由约束与最终验证
- 使用 KRT 不等于获得自动布线授权。项目禁止自动布线时，只使用获准的检查、复制、文字整理或明确路径局部编辑；不调用自动路由入口。丝印工具也应先确认只改变文字/图形，核对封装位姿和铜几何没有被移动。
- 指定线宽、线距、过孔时使用适当的
--escalation off。不采用默认降级来获得表面连通，不擅自启用--clearance-ceiling或--relax-drc-severities。即使用--no-fix-drc-settings，仍比较前后工程规则，部分版本可能写入输出工程下限。 - 路由结束核查失败、开路、多端网络和实际铜连接，不以 routed 数量表示成功。
- 对最终保存版本执行 KiCadRoutingTools
check_connected.py、按实际项目规则配置的check_drc.py，以及原生 KiCad 填铜后的 DRC。检查独立工具默认跳过的项目，例如焊盘到板边；由原生或其它适用检查覆盖并披露范围。 - MCP 重新绑定最终结果，核对工程、叠层、规则和适用的原理图/PCB 一致性检查。MCP 若调用同一原生 CLI DRC，不算额外一次独立算法验证；不为凑次数重复同一检查。
- 使用 pcbnew 时取运行时层常量/层表，不硬编码 B.Cu 数字 ID；访问过孔线宽等 API 时遵循当前签名，必要时显式传铜层。圆弧必须按圆弧处理，不能由只认识线段的自编检查器静默按弦长或端点切向代替。
报告实际工具/后端、版本、对象哈希、参数、返回状态及检查范围；自动检查、解析模型、信号完整性仿真和实测的结论分别标识。