KiCad MCP Server

社区

用自然语言管理并分析 KiCad 电路板设计

分类: 开发工具第 176 / 438
Stars: ★ 528 热门
传输方式: stdio（本地进程）
运行环境: Python 3.10+ · 预编译二进制 KiCad 9.0+ (required
凭据: 无需凭据
许可证: MIT
最近提交: 12 个月前 ⚠
工具数: 1

56FMRS · C

一个文档完善、结构清晰的社区 KiCad MCP 服务器，功能覆盖项目管理、分析、BOM、DRC、可视化和模式识别，适合在 Claude Desktop 等 MCP 客户端中用自然语言操作 KiCad 设计，但需要本地 Python/uv 环境和手动配置，且非官方产品。

最强项 · 文档质量 15/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

11/20

维护活跃度

10/20

文档质量

15/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: README 描述了资源/工具/提示三类能力及项目结构（server.py、resources/、tools/、prompts/、tests/），但未提供任何可验证的执行证据：没有 CI 工作流文件、没有测试运行日志，也无法确认声明的工具（如 open_project、DRC 检查、BOM 导出、缩略图生成）与实际行为一致。由于是纯静态审查且缺乏可复现的执行证据，按规定可靠性上限为 12 分，鉴于证据稀薄进一步扣分至 8 分。
安全与权限 11/20: 该服务器会启动本地 KiCad 应用、调用 KiCad CLI 执行 DRC 检查、读取用户可配置路径下的项目文件并生成输出文件，属于具有真实副作用的本地自动化工具。README 未说明这些操作前是否有用户确认机制，也未披露最小权限边界或数据流范围（例如搜索路径以外的文件是否可能被访问）。未发现凭证窃取、隐蔽外传、不可逆删除/远程命令等红线行为，但风险披露和权限控制说明不完整，故评为中等偏下的 11 分。
维护活跃度 10/20: 项目采用 MIT 许可证，仓库未被归档，存在 494 星和 29 个未关闭 issue，表明有一定关注度，但材料中未包含提交历史、发布节奏、依赖更新策略或安全响应渠道等治理信息，无法判断维护活跃度和响应速度，故评为中等的 10 分。
文档质量 15/20: README 结构完整，包含前置条件、安装步骤、配置说明、故障排查、贡献指南，并链接到 docs/ 目录下多个专题指南（项目管理、DRC、BOM、网表提取、缩略图、模式识别、配置、开发指南）。这体现了分层文档的良好实践，但对工具参数细节、成本/性能限制、以及被引用子文档的实际内容缺乏可验证的证据，故未给满分，评为 15 分。
安装易用性 12/20: 安装步骤清晰（克隆仓库、make install 使用 uv、复制 .env、运行 main.py、手动编辑 Claude Desktop 配置 JSON 并替换绝对路径、重启客户端），跨平台支持 Mac/Windows/Linux，但配置示例偏向 macOS 路径，且需要手动填写绝对路径、手工编辑 JSON 配置文件，过程仍属人工且容易出错。由于是静态审查且无可验证的执行证据，按规定上限为 15 分，因流程手动脆弱进一步扣分至 12 分。

静态评测 · 未实际运行收录于 2026-09-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件执行命令或代码

适合谁

使用 KiCad 9.0+ 进行 PCB/硬件设计的工程师
希望在 Claude Desktop 等 MCP 客户端中用自然语言查询设计数据的用户
需要跨 macOS、Windows、Linux 工作的团队

不适合谁

不使用 KiCad 或使用低于 9.0 版本的用户
没有 Python 3.10+ 和 uv 环境的用户
期待一键安装、无需本地配置的用户

所需权限

读取本机 KiCad 项目目录（由 KICAD_SEARCH_PATHS 等环境变量指定）
读取 KiCad 项目、原理图和 PCB 文件
调用 KiCad CLI 执行 DRC 等操作
启动 KiCad 应用程序
生成可视化缩略图和导出文件（如 BOM）

风险与副作用

服务器可读取本机设计文件，项目搜索路径配置过宽可能暴露无关文件
部分工具具有副作用（打开应用、生成文件），调用前应有用户确认
需要社区维护，可能存在 bug 或与 KiCad 新版本不兼容
客户端配置中必须使用绝对路径，否则可能因工作目录未定义而失败

安装接入

准备工作

运行环境：Python 3.10+ · 预编译二进制 KiCad 9.0+ (required

其他可选配置项（3 个）

KICAD_SEARCH_PATHS 可选逗号分隔的 KiCad 项目搜索目录列表，在项目根目录的 .env 文件中设置。

KICAD_USER_DIR 可选覆盖默认的 KiCad 用户目录，可选，在 .env 中设置。

KICAD_APP_PATH 可选覆盖默认的 KiCad 应用程序路径，例如 /Applications/KiCad7/KiCad.app，可选。

1) git clone https://github.com/lamaalrajih/kicad-mcp.git 并进入目录；2) 先安装 uv（brew install uv 或 pipx install uv），然后运行 make install 自动创建 .venv 并安装依赖；3) 复制 .env.example 为 .env，配置 KICAD_SEARCH_PATHS（逗号分隔的 KiCad 项目目录）、可选 KICAD_USER_DIR 和 KICAD_APP_PATH；4) 运行 python main.py 启动服务器；5) 在 Claude Desktop 配置文件（如 ~/Library/Application Support/Claude/claude_desktop_config.）的 mcpServers 中添加 kicad 条目，command 指向 .venv/bin/python 的绝对路径，args 指向 main.py 的绝对路径；6) 重启 MCP 客户端。

claude_desktop_config.json

{"mcpServers":{"kicad":{"command":"/ABSOLUTE/PATH/TO/YOUR/PROJECT/kicad-mcp/.venv/bin/python","args":["/ABSOLUTE/PATH/TO/YOUR/PROJECT/kicad-mcp/main.py"]}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "kicad": {
      "command": "/ABSOLUTE/PATH/TO/YOUR/PROJECT/kicad-mcp/.venv/bin/python",
      "args": [
        "/ABSOLUTE/PATH/TO/YOUR/PROJECT/kicad-mcp/main.py"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add kicad -- /ABSOLUTE/PATH/TO/YOUR/PROJECT/kicad-mcp/.venv/bin/python /ABSOLUTE/PATH/TO/YOUR/PROJECT/kicad-mcp/main.py

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

重启 MCP 客户端后，在工具列表中应能看到 kicad 服务器的 open_project 工具；也可以直接问“我有哪些 KiCad 项目？”来验证连接正常。

常见排障

服务器未出现在客户端：检查配置文件 JSON 格式及 Python 解释器、main.py 的绝对路径是否正确
确认 Python 环境中可访问 mcp 包
确认本机 KiCad 安装被正确检测到
查看服务器日志：~/Library/Logs/Claude/mcp-server-kicad.log 和 ~/Library/Mcp.log（macOS 下 Claude 日志目录）
在配置文件和 .env 中始终使用绝对路径，避免工作目录未定义的问题
仍无法解决时可在 GitHub 上提交 issue

试试这样问

连接成功后，可以直接对 AI 助手这样说：

显示我最近的所有 KiCad 项目，按修改时间排序
打开我的 Arduino shield 项目
我的温度传感器板子上元件密度怎么样？
给我的音频放大器 PCB 生成一张缩略图

工具能力 1

open_project 写入

启动 KiCad 并打开指定的项目

使用场景

按修改时间列出并打开最近的 KiCad 项目

分析 PCB 的元件密度与间距

从原理图提取元件连接关系（网表）

生成和导出物料清单（BOM）

通过 KiCad CLI 运行 DRC 并跟踪违规修复进度

生成 PCB 布局的缩略图可视化

识别原理图中的电源拓扑等常见电路模式

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

KiCad MCP Server 是一个面向 KiCad 的 Model Context Protocol 服务器，支持 macOS、Windows 和 Linux。它将 KiCad 项目管理、PCB 分析、网表提取、BOM 管理、DRC 检查、PCB 可视化和电路模式识别等能力暴露给任意兼容 MCP 的客户端（如 Claude Desktop），让用户可以用自然语言与自己的硬件设计项目交互。该项目要求 Python 3.10+、KiCad 9.0+、uv 0.8.0+，采用模块化结构（resources/tools/prompts/utils），以 MIT 许可证开源，由社区维护，并非 KiCad 官方产品。