3步看懂AI辅助PCB设计KiCAD MCP Server项目概览与244个工具全景地图【免费下载链接】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是一个基于模型上下文协议MCP的开源服务器让 Claude 等 AI 助手能够直接操作 KiCAD 进行电路板PCB设计画原理图、布局元件、自动布线、导出 Gerber 文件——全部用一句自然语言完成。截至 v2.8.2它已注册244 个工具覆盖 17 大类别支持 Linux、Windows 和 macOS。不管你是想体验AI 画板的硬件新手还是想自动化繁琐设计流程的工程师本文只需 3 步就能让你彻底看懂这个项目。第1步它是什么——AI 与 KiCAD 之间的翻译官 核心原理一句话AI 助手说人话 → MCP 协议翻译 → TypeScript 服务器接收 → Python 层调用 KiCAD 的 pcbnew API 真正干活。整个系统分两层架构清晰官方文档 docs/ARCHITECTURE.md 中有完整说明层级技术栈职责上层服务器TypeScriptsrc/实现 MCP 协议、注册工具、校验参数、管理 Python 子进程底层接口Pythonpython/通过 pcbnew SWIG 或 KiCAD IPC API 执行真正的板级/原理图操作关键入口文件工具注册与路由src/tools/registry.ts、src/tools/router.tsPython 命令入口python/kicad_interface.py后端自动检测SWIG / IPC 二选一python/kicad_api/factory.py对新手意味着什么你不需要写任何 Python 或 C只要在 Claude Desktop、Claude Code、Cline 或 OpenCode 里连上这个服务器就能用日常语言指挥 KiCAD。第2步如何安装——最快上手配置方法 环境要求一览软件版本要求说明KiCAD9.0需包含 pcbnew Python 模块Node.js18运行 MCP 服务器Python3.9KiCAD 自带版本即可推荐MCP 客户端任意Claude Desktop / Claude Code / Cline / OpenCode三种平台最快路径 LinuxUbuntu/Debian主力平台测试最充分git clone --branch stable https://gitcode.com/gh_mirrors/ki/KiCAD-MCP-Server cd KiCAD-MCP-Server npm install pip3 install -r requirements.txt npm run buildWindows 10/11推荐自动脚本.\setup-windows.ps1脚本会自动检测 KiCAD 安装、验证前置条件、装依赖、构建并生成配置详见 setup-windows.ps1。macOS实验性支持./setup-macos.sh --apply脚本会解析 KiCAD 内置 Python 环境并生成 Claude Desktop 配置详细说明见 setup-macos.sh。连接你的 AI 客户端仓库的 config/ 目录提供了主流客户端的现成配置示例Claude Desktopconfig/claude-desktop-config.jsonVS Codeconfig/vscode-mcp.example.jsonLinux / macOS / Windows 示例config/linux-config.example.json、config/macos-config.example.json、config/windows-config.example.json配置方法完整指南见 docs/CLIENT_CONFIGURATION.md平台差异细节见 docs/PLATFORM_GUIDE.md。第3步244个工具全景地图——AI 能替你做什么️完整清单由脚本自动生成并随版本更新收录在 docs/TOOL_INVENTORY.mdv2.8.2 快照其中184 个工具已建立关键词索引可通过search_tools按关键字发现。下面是按功能分组的能力地图 项目与板级管理31 个create_project、open_project、save_project、set_board_size、add_board_outline、add_mounting_hole、get_board_2d_view……从新建项目到画板框、打安装孔一气呵成源码在 src/tools/project.ts 与 src/tools/board.ts。 元件布局28 个place_component、move_component、batch_move_components、align_components、suggest_placement智能布局建议、hierarchical_place按原理图层级聚类摆放……这是数量最大的类目之一见 src/tools/component.ts。⚡ 布线与自动布线21 个手动route_trace、add_via、route_differential_pair差分对、add_copper_pour铺铜 自动集成Freerouting自动布线器Java / Docker / Podman 均可运行一条autoroute命令跑完全板。用法详解见 docs/FREEROUTING_GUIDE.md。 原理图全流程65 个最大类目从create_schematic到annotate_schematic自动编号、sync_schematic_to_boardF8 同步、run_erc电气规则检查还包含批量操作src/tools/schematic-batch.ts、层次化子图src/tools/schematic-hierarchy.ts与布局整理src/tools/schematic-layout.ts。约 1 万个动态符号库开箱可用。 导出与生产输出27 个Gerber、ODB、IPC-2581、BOMCSV/XML/HTML/JSON、网表、3D 模型STEP/STL、坐标文件贴片用……交板生产所需格式几乎全覆盖见 src/tools/export.ts。 元器件采购与生态集成18 个JLCPCB 嘉立创250 万 元件目录可下载本地 SQLite 库做离线搜索、查库存价格、找更便宜的替代料docs/JLCPCB_USAGE_GUIDE.mdDigi-Key按料号/参数搜索、库存与生命周期检查LCSC 数据手册自动补全元件手册链接Eagle / Altium / PADS 等导入import_eagle_project、import_pcb跨平台迁移设计GUI 驱动实验性11 个工具可直接驱动 KiCAD 图形界面的菜单与对话框✅ 设计与质量保障9 个run_drc设计规则检查、set_design_rules、validate_schematic、validate_symbol_library精确定位到行/列的结构错误、check_placement_clearance间距冲突分类。 工具发现3 个强烈推荐新手用面对 244 个工具别慌——list_tool_categories浏览分类、search_tools按关键词查找、get_category_tools查看某类全部工具AI 助手会自己调用它们。新手实战一句自然语言的威力 README 中给出的典型工作流可以直接抄作业创建一个叫 LEDBoard 的新 KiCAD 项目板子 50mm × 50mm四角各放一个 3mm 安装孔然后在每层铺 GND 铜皮最后跑一次 DRC 并导出 Gerber。完整示例元件放置、布线、自动布线、嘉立创选型见 README.md 的 Usage Examples 一节。常见问题与延伸阅读 场景去哪找答案安装/环境问题docs/KNOWN_ISSUES.md、docs/WINDOWS_TROUBLESHOOTING.mdIPC 实时后端状态docs/IPC_BACKEND_STATUS.mdPCB 设计工作流docs/PCB_DESIGN_WORKFLOW.md原理图工具参考docs/SCHEMATIC_TOOLS_REFERENCE.md版本更新记录CHANGELOG.md路线图即将推出什么docs/ROADMAP.md小提示安装请始终克隆stable分支——它只在正式发布时更新main分支可能包含尚未发布的修改。写在最后KiCAD MCP Server 把 KiCAD 的鼠标操作变成了自然语言对话244 个工具覆盖从建项、画原理图、布局布线到导出生产文件的完整闭环再用search_tools让 AI 自己找到该用的工具。如果你还在手工点击 KiCAD 的每一个菜单不妨按本文 3 步试一次——让 AI 帮你把板子跑完也许只需要一段对话。【免费下载链接】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），仅供参考