KiCAD-MCP-Server

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 409 🐛 待处理 22 👀 关注 28

GitHub ↗

GitHub 星标 ★ 3135

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源免费，无在线服务

项目预览

KiCAD-MCP-Server 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类智能体

开发团队mixelpixx

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

定价模式🏷️完全免费

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

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Python

GitHub 星标★ 3135

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

代码更新2026-11-03

仓库体积4.8 MB

本站数据更新2026-11-04

维护状态活跃

收录时间2026-09-15

浏览次数1

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-15 · 当前星标 ★ 3135

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 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 许可证，可自由用于个人与商业场景。