Kicad Mcp Pro

KiCad MCP Pro 是面向 KiCad EDA 工作流的模型上下文协议服务。它提供用于原理图、PCB、验证、DFM 和制造导出的自动化工具、资源和提示词。

该服务现在默认以受限的 default 配置启动：提供 24 个只读审核工具，而非完整的专家目录。若要进行受控编辑，请使用启用写入模式的 build；若要进行人工把关的交接，请使用启用制造模式的 release；仅在高级且可信的客户端中使用 expert/full。当前工具目录数量和上下文大小估算来自 docs/evidence/progressive-disclosure-profile-snapshot.json；详见 docs/agents/progressive-disclosure.md。

遥测和错误报告默认处于禁用状态。启用 OpenTelemetry 的配置说明见 docs/configuration.md，隐私规则见 docs/privacy.md。

范围与诚信

KiCad MCP Pro 是一款专业的初步设计与审查助手，并非自动签核机构。ERC/DRC 和导出流程由 KiCad 自身的引擎驱动。信号完整性、电源完整性、电磁兼容性和热分析工具提供的是一阶闭式估算（精度通常约为 5–10%）——适用于快速初步审查，不能替代 2D/3D 场求解器、电磁/有限元仿真或正式签核。实时元器件采购默认使用 JLCPCB 公共目录；只有配置了 API 凭据后，才能使用 Nexar、DigiKey 和 Mouser。服务驱动 KiCad 程序化功能面的覆盖比例，会在能力覆盖矩阵中公开跟踪。工具数量和能力覆盖率是清单指标，而非衡量产品质量的首要指标。端到端任务结果、变更恢复、数据损坏、必要的 DRC 执行以及制造可复现性才是结果 KPI。已提交的原生实时示例证据有意标记为 insufficient_evidence；在 #730 中的资格验证工作完成之前，代表性语料库目标的达成情况仍单独处理。

项目身份

字段	值
规范仓库	oaslananka/kicad-mcp-pro
PyPI 软件包	kicad-mcp-pro
npm 封装	kicad-mcp-pro
MCP Registry 名称	io.github.oaslananka/kicad-mcp-pro
版本	4.4.0
OSS 成熟度报告	docs/repo-maturity-report.md
OpenSSF 证据	docs/openssf-evidence.md

快速开始

桌面应用

从 GitHub 发布页面下载最新安装程序。 Tauri 桌面应用会自动启动 Python 仪表板服务，并在 http://127.0.0.1:3334/ui 打开 GUI。桌面版会启动完全匹配的后端版本，并在使用前验证其桌面兼容性握手；请参阅安装。

CLI

uvx kicad-mcp-pro init
uvx kicad-mcp-pro tray
uvx kicad-mcp-pro dashboard --open
uvx kicad-mcp-pro --transport streamable-http --port 3334

KiCad PCB 编辑器配套工具（开发预览版）

现有的 KiCad PCM Companion 正在升级为 KiCad 10 IPC 工具栏插件，位于 packages/kicad-plugin/。它会读取当前打开的 PCB，并链接到现有的本地仪表板。IPC 升级为只读；实时桌面验收和发布尚未完成。

Web 仪表板

uvx kicad-mcp-pro dashboard --host 127.0.0.1 --port 3334 --open
# http://127.0.0.1:3334/ui

文档

文档按从设置到操作的顺序组织：

1. 安装
2. 客户端配置
3. 运行时配置
4. 工具参考
5. 工作流
6. 发布流程
7. 安全与隐私
8. KiCad 能力覆盖情况 — 服务驱动 KiCad 程序化功能面的覆盖程度
9. 错误代码目录 — 稳定的错误代码、重试类别和恢复方法
10. 工作单审计 — 当前加固工作单的状态

kicad_capability_parity() 工具会按工作流领域报告本服务能够驱动 KiCad 程序化可访问功能面的覆盖比例（目前为 76.6%），并将真正的 gap 与 KiCad 未提供无头 API 的 gui-only-no-api 项目区分开来。

已发布的文档网站位于 https://oaslananka.github.io/kicad-mcp-pro/。

传输方式

KiCad MCP Pro 支持 stdio 和 Streamable HTTP。Streamable HTTP 默认由 /mcp 提供服务，可通过 KICAD_MCP_MOUNT_PATH 更改路径。

uvx kicad-mcp-pro --transport streamable-http --host 127.0.0.1 --port 3334

Streamable HTTP 客户端必须发送 Accept: application/json, text/event-stream 和 Content-Type: application/json。主要的公开 MCP 契约为 2026-07-28：现代客户端会发送 MCP-Protocol-Version: 2026-07-28、最终协议要求的 方法／名称传输标头，以及每个请求的客户端元数据封装。

仍支持向后兼容的 2025-11-25 客户端，它们通过 SDK 的 旧版 initialize 协商流程进行连接。这些客户端会在后续请求中回传协商得到的协议 版本；当 KICAD_MCP_STATEFUL_HTTP=1 时，也会回传 MCP-Session-Id。最终版 2026-07-28 流量是无状态的，不会创建 MCP 会话。

默认情况下，已弃用的 HTTP+SSE 回退路由处于禁用状态。仅当较旧的客户端无法使用 Streamable HTTP 时，才设置 KICAD_MCP_LEGACY_SSE=1。

安装

已发布的软件包：

uvx kicad-mcp-pro --help
npx kicad-mcp-pro --help

在受支持的 Linux 主机上全新检出源代码：

./scripts/bootstrap-dev.sh
source .dev-env.sh
pnpm run dev:doctor -- --ci

仓库引导程序会将固定校验和的 Python、uv/uvx、Node.js、 pnpm、Task 和 Rust 工具安装到检出目录本地的忽略路径中，并执行冻结依赖项安装。 它不会修改全局工具目录。有关 --core-only、--check、清理、升级和 KiCad 功能模式，请参阅可复现引导指南。

软件包元数据

规范元数据输入包括用于软件包版本和仓库标识的 pyproject.toml，以及用于 KiCad 和 MCP 支持策略的 compatibility.yaml。server.json 是生成的注册表清单。pnpm run metadata:sync 会生成公开内容，pnpm run metadata:check 会在 CI 和发布验证中对其进行检查。

用法

使用 kicad-mcp-pro --help 查看 CLI 命令，并参阅 docs/client-configuration.md 配置 MCP 客户端。生成的工具目录见 docs/tools-reference.generated.md。

Agent 插件和技能

此仓库负责 KiCad MCP Pro 的产品级 Agent 插件和 KiCad 专用技能。中央 agent-tools 仓库应收录此插件，但清单和工作流说明保存在此处，以便与实际的 MCP 服务工具保持同步。

文件	用途
.claude-plugin/plugin.json	面向兼容 Agent 运行时和市场目录的产品级插件清单。
.mcp.json	Claude Code 项目本地 MCP 服务配置。
.codex/config.example.toml	Codex CLI MCP 配置示例。
.vscode/mcp.example.json	VS Code / GitHub Copilot 工作区 MCP 配置示例。
integrations/opencode/opencode.example.json	OpenCode 项目 MCP 配置示例。
.opencode/skills/	OpenCode 原生镜像技能定义。
docs/agent-runtime-config.md	Agent 运行时设置和验证矩阵。
skills/kicad-design-review/SKILL.md	全面的 KiCad 设计审查技能。
skills/pcb-design/SKILL.md	PCB 设计、布局检查、元件放置、布线、叠层和电路板质量工作流。
skills/drc-check/SKILL.md	ERC/DRC 执行、分类处理、豁免审查和重新验证工作流。
skills/fabrication-output/SKILL.md	制造文件导出、DFM、发布依据和生产文件包工作流。
skills/schematic-review/SKILL.md	原理图检查、ERC、连通性、电源、符号和可读性工作流。

Agent 设置

KiCad MCP Pro 可通过已发布的 Python 软件包、npm 封装程序，或 server.json 中声明的容器元数据启动。常见的本地启动方式如下：

uvx kicad-mcp-pro --transport stdio
uvx kicad-mcp-pro --transport streamable-http --host 127.0.0.1 --port 3334
npx kicad-mcp-pro --help

对于源码检出，在发布插件更改前，请运行常规的仓库验证流程：

corepack pnpm run metadata:check
python3 -m json.tool .claude-plugin/plugin.json >/dev/null

验证工作流

在将此插件列为 agent-tools 中的有效插件之前，请至少验证一个兼容的 Agent 运行时能够：

1. 发现 .claude-plugin/plugin.json。
2. 通过 stdio 或 Streamable HTTP 启动或连接到 kicad-mcp-pro。
3. 调用 kicad_get_server_info 或 kicad_get_project_info。
4. 从 skills/ 加载技能并遵循工作流，且不引用缺失的工具。
5. 分别报告 ERC、DRC、DFM、导出产物、假设和人工审查要求。

KiCad MCP Pro 是工程助手，不是自主制造签核机构。生成的 PCB 和生产文件必须经过合格人员审查，才能进行制造或组装。

开发

新贡献者应先阅读 ARCHITECTURE.md，其中介绍了五层架构（传输层 → MCP 协议 → 编排层 → KiCad 适配器边界 → 纯领域层），并准确说明了如何添加新工具。运行时模型和 质量门禁栈记录在 docs/development/architecture.md 中。

项目使用 Taskfile.yml 管理常见开发命令。克隆仓库后：

task install     # Install all dependencies (pnpm + uv)
task verify      # Run the local quality gate: lint → format → typecheck → test → build
task test        # Run unit tests only
task lint        # Run lint and metadata checks
task format      # Auto-format the codebase
task typecheck   # Run strict static type checking
task build       # Build release artifacts
task ci          # Run the local equivalent of the full CI pipeline
task hooks       # Install repository-pinned Lefthook git hooks

所有更改都必须通过 task verify，才能提交拉取请求。

贡献

提交拉取请求前，请阅读 CONTRIBUTING.md。所有更改都必须通过仓库的格式、代码检查、类型检查、测试、工作流、安全和软件包元数据门禁。

独立行业报道

• JLCPCB（2026 年 10 月 14 日） — KiCad MCP：如何使用 Claude Code 设计 PCB介绍了 KiCad MCP Pro 的实操工作流，用于设计 XL4015/LM358 降压转换器，其中包括检查和局限性。该电路板尚未制造，也未经台架测试。这是独立报道，并非 JLCPCB 的认可或合作；正在通过 #1314 评估所报告的问题。

引用本软件

如果您在研究或技术出版物中使用 KiCad MCP Pro，请通过其 DOI 引用 归档版本（完整元数据请参见 CITATION.cff）：

@software{aslan_kicad_mcp_pro,
  author  = {Aslan, Osman},
  title   = {KiCad MCP Pro},
  license = {MIT},
  url     = {https://github.com/oaslananka/kicad-mcp-pro},
  doi     = {10.5281/zenodo.21283791}
}

每个 GitHub 版本发布都会存档到 Zenodo，并归属于此概念 DOI；该 DOI 始终指向最新版本。

许可证

KiCad MCP Pro 根据 MIT 许可证提供。