KiCAD-MCP-Server

让 Claude 直接画 PCB，说句话就改板子

KiCAD-MCP-Server 是一个基于 Model Context Protocol（MCP）的开源服务，让 Claude 等大语言模型能够直接操作 KiCAD 完成印刷电路板设计。它解决的核心问题是：传统 PCB 设计需要工程师手动在 KiCAD 图形界面里反复放置元件、连线、铺铜，而 LLM 虽然能理解电路意图，却无法直接驱动 EDA 工具。该项目把 KiCAD 的常用操作封装成 MCP 工具，模型通过自然语言即可创建/打开工程、添加元件与封装、绘制走线、生成网络表、导出 Gerber 等，把“说需求”变成“改板子”。核心能力包括对 KiCAD 工程文件的读写、元件库检索与放置、原理图与 PCB 联动、以及把设计结果反馈给模型做迭代。对硬件工程师和 AI 智能体开发者而言，它提供了让 LLM 参与硬件设计的可编程接口，适合做自动化原型、教学演示和 AI 辅助布线实验。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2323

维护状态较活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队mixelpixx

所属国家

官网地址

GitHubhttps://github.com/mixelpixx/KiCAD-MCP-Server

定价模式free

价格说明开源免费，无在线服务

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型

GitHub 星标★ 2323

30天Star增速

HF 下载量

上线时间2025-04-26 00:00:00

最近更新2026-09-17 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-15

浏览次数0

使用教程

难度：入门约 20 分钟部署方式：本地安装 7 步

环境要求

KiCAD 9.0 或更高版本（需先安装）
Node.js 18 及以上
Python 3.11 及以上
能够访问 GitHub 与 npm 源以完成克隆和依赖安装

安装与启动步骤

1安装 KiCAD 9.0+

从 KiCAD 官网下载并安装 9.0 或更高版本，MCP 服务需要调用本机 KiCAD 才能操作工程。
2安装 Node 与 Python

安装 Node.js 18+ 和 Python 3.11+，两者都是本项目构建与运行的前置条件。
3克隆项目仓库

把 KiCAD-MCP-Server 源码下载到本地，建议放在无中文、无空格的路径下。
```
git clone https://github.com/mixelpixx/KiCAD-MCP-Server.git
```
4进入项目目录

后续所有安装和构建命令都要在克隆出来的项目根目录里执行。
```
cd KiCAD-MCP-Server
```
5安装依赖

用 npm 安装项目声明的 Node 依赖，首次执行耗时较长，需保持网络畅通。
```
npm install
```
6构建项目

执行构建脚本产出可运行的服务，命令成功结束即表示编译通过。
```
npm run build
```
7配置 AI 客户端

按官方平台指南把本服务注册到 Claude Desktop、Claude Code、VS Code 等 MCP 客户端。

如何确认成功

npm run build 执行完成且无报错，即表示服务构建成功；随后按 docs/PLATFORM_GUIDE.md 配置客户端并在 MCP 客户端中确认服务已连接。

常见问题

Q：必须先安装 KiCAD 吗？

A：是，Quick Start 第一步要求安装 KiCAD 9.0+，服务需要调用本机 KiCAD 来创建工程、放置元件和导出 Gerber。

Q：一定要同时装 Node.js 和 Python 吗？

A：是，README 明确要求 Node.js 18+ 与 Python 3.11+ 同时具备，克隆后还需要用 npm 安装依赖并构建。

Q：怎么把服务接入 Claude 等客户端？

A：README 指向 docs/PLATFORM_GUIDE.md 平台指南，按其中的说明在 Claude Desktop、Claude Code、VS Code 等 MCP 客户端里配置。

Q：这个 Python/TypeScript 版本还维护吗？

A：维护中。README 说明新的 Konnect 是 Rust 重写版，而本仓库仍以 MIT 协议开放并持续维护。

注意事项

README 只给出了克隆、npm install、npm run build 的构建流程，客户端的具体配置项请以 docs/PLATFORM_GUIDE.md 为准。
项目基于 MCP 协议，可与 claude.ai、Claude Desktop、Claude Code、VS Code 以及任意 MCP 客户端配合使用。
官方推荐的新一代实现 Konnect 为 Rust 原生 KiCAD 10 插件，属于另一个仓库，不影响本项目使用。
本 Python/TypeScript 服务使用 MIT 许可证，可自由用于个人与商业场景。

核心亮点

把 KiCAD 操作封装成 MCP 工具，LLM 可自然语言驱动 PCB 设计
覆盖工程创建、元件放置、走线、导出 Gerber 等核心流程
Python 实现，接入 Claude 等 MCP 客户端门槛低，适合做硬件智能体原型

不足之处

依赖 KiCAD 本地环境与版本，跨平台和版本兼容性需自行验证
复杂高速布线与设计规则检查仍难完全交给模型，实际产出需人工复核

适用场景

AI 辅助快速生成简单电路板原型并导出制造文件
硬件教学场景中让学生用自然语言理解 PCB 设计流程
智能体开发者把 EDA 能力接入自动化硬件设计工作流

替代项目

kicad-skip、pcbnew、OpenROAD

项目介绍

KiCAD-MCP-Server 是一个智能体领域的开源项目，官方简介：KiCAD 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.。项目使用 Python 开发，在 GitHub 上获得 2246 星标。

上一篇：jiuwenswarm

下一篇：1.0-Secure-Ai-Agent-Infrastructure