# kicad-mcp-pro — KiCad MCP Server (PCB/Schematics)

> kicad-mcp-pro is an MCP server for KiCad PCB/schematic workflows; verified 120★ and ships a `uvx` quick start with `health` and `doctor` diagnostics.

## Install

Merge the JSON below into your `.mcp.json`:

## Quick Use

```bash
uvx kicad-mcp-pro --help
uvx kicad-mcp-pro health --json
uvx kicad-mcp-pro doctor --json
uvx kicad-mcp-pro serve
```

## Intro

kicad-mcp-pro is an MCP server for KiCad PCB/schematic workflows; verified 120★ and ships a `uvx` quick start with `health` and `doctor` diagnostics.

**Best for:** Hardware teams using agents to inspect KiCad projects, run checks, and automate repeatable PCB workflows

**Works with:** Python 3.12+ per README badge; MCP clients; requires project paths via env/config

**Setup time:** 8-18 minutes

### Key facts (verified)

- GitHub: 120 stars · 13 forks · pushed 2026-05-14.
- License: MIT · owner avatar + repo URL verified via GitHub API.
- README-backed entrypoint: `uvx kicad-mcp-pro serve`.

## Main

- Run `health --json` and `doctor --json` before wiring into an agent so you can debug environment/path issues without opening KiCad.

- Keep MCP config explicit: pass absolute project paths and a dedicated workspace root to avoid accidental edits outside the intended repo.

- Start with read-only inspection and validation checks, then expand into edits/export only after you trust the safety gates.

### Source-backed notes

- README provides a `uvx` quick start including `health --json`, `doctor --json`, and `serve` commands.
- README states `health --json` is safe when KiCad is not running and reports IPC as deferred instead of crashing.
- README includes a minimal MCP config example and references integration docs for Claude Desktop/Code and other clients.

### FAQ

- **Is this the canonical repo?**: README mentions a canonical repo under `oaslananka-lab/` and also a personal mirror; this asset cites the published mirror URL.
- **Do I need KiCad running?**: Not for `health --json`; README says IPC checks are deferred when KiCad isn’t running.
- **How do I keep it safe?**: Start read-only, scope paths explicitly, and add a review gate before allowing edit/export tools.

## Source & Thanks

> Source: https://github.com/oaslananka/kicad-mcp-pro
> License: MIT
> GitHub stars: 120 · forks: 13

---

<!-- ZH -->

## Quick Use

```bash
uvx kicad-mcp-pro --help
uvx kicad-mcp-pro health --json
uvx kicad-mcp-pro doctor --json
uvx kicad-mcp-pro serve
```

## Intro

kicad-mcp-pro 是面向 KiCad PCB/原理图流程的 MCP server；已验证 120★，提供 `uvx` 快速启动，并内置 `health`/`doctor` 诊断命令。

**Best for:** 希望用 agent 检查 KiCad 项目、跑校验并自动化 PCB 流程的硬件团队

**Works with:** README 徽章标注 Python 3.12+；兼容 MCP 客户端；通过 env/config 指定项目路径

**Setup time:** 8-18 minutes

### Key facts (verified)

- GitHub：120 stars · 13 forks；最近更新 2026-05-14。
- 许可证：MIT；作者头像与仓库链接均已通过 GitHub API 复核。
- README 中可对照的入口命令：`uvx kicad-mcp-pro serve`。

## Main

- 在接入 agent 前先跑 `health --json` 与 `doctor --json`，把环境/路径问题先排干净。

- 保持 MCP 配置显式：使用绝对路径并设定 workspace root，避免越界修改到不该动的目录。

- 先从只读检查与校验入手；安全门禁稳定后再扩展到编辑/导出能力。

### Source-backed notes

- README 提供 `uvx` quick start：包含 `health --json`、`doctor --json` 与 `serve`。
- README 说明 `health --json` 在 KiCad 未运行时也可安全执行，并会把 IPC 标为 deferred。
- README 给出最小 MCP 配置示例，并提供 Claude Desktop/Code 等多客户端集成文档入口。

### FAQ

- **这是 canonical 仓库吗？**：README 提到 canonical 在 `oaslananka-lab/`，同时有个人镜像；本资产以发布镜像 URL 为 Source 引用。
- **必须开着 KiCad 吗？**：不需要。README 指出 `health --json` 在 KiCad 未运行时也安全。
- **如何更安全地用？**：先只读、显式限定路径，并在允许编辑/导出工具前加入人工审核门禁。

## Source & Thanks

> Source: https://github.com/oaslananka/kicad-mcp-pro
> License: MIT
> GitHub stars: 120 · forks: 13


---
Source: https://tokrepo.com/en/workflows/kicad-mcp-pro-kicad-mcp-server-pcb-schematics
Author: MCP Hub