KiCad MCP server for KiCad 10 using kipy (official KiCad Python API)
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"kicad-mcp-kipy","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# kicad-mcp-kipy **KiCad MCP server for KiCad 10** — powered by [kipy](https://pypi.org/project/kicad-python/), the official KiCad Python API. Connects AI assistants (Claude, Bob, etc.) to a running KiCad 10 instance via the [Model Context Protocol](https://modelcontextprotocol.io/), enabling real-time inspection and control of schematics and PCB layouts. ## Why kicad-mcp-kipy? | | [kicad-mcp (Huaqiu)](https://github.com/Huaqiu-Electronics/kicad-mcp) | **kicad-mcp-kipy** | |---|---|---| | KiCad 10 support | ❌ (KiCad 9 JSON API) | ✅ (KiCad 10 Protobuf API) | | macOS process detection | ❌ ([Issue #3](https://github.com/Huaqiu-Electronics/kicad-mcp/issues/3)) | ✅ | | Dependencies | 115 packages | ~40 packages | | Python API | Custom JSON/NNG | kipy (official KiCad bindings) | ## Requirements - KiCad 10.x (macOS / Linux / Windows) - Python 3.11+ - [uv](https://github.com/astral-sh/uv) (recommended) or pip ## Installation ### Using uvx (recommended — no install needed) ```bash uvx kicad-mcp-kipy ``` ### Using pip ```bash pip install kicad-mcp-kipy kicad-mcp-kipy ``` ## Setup ### 1. Enable KiCad IPC API In KiCad's Schematic Editor or PCB Editor: **Preferences → Preferences → Scripting → Enable IPC API** ✅ ### 2. Register in your MCP client (Bob / Claude Desktop) **.bob/mcp.json** (workspace-level): ```json { "mcpServers": { "kicad": { "command": "uvx", "args": ["kicad-mcp-kipy"] } } } ``` **Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json`): ```json { "mcpServers": { "kicad": { "command": "uvx", "args": ["kicad-mcp-kipy"] } } } ``` ### 3. Open a project in KiCad Open your schematic or PCB file in KiCad **before** connecting — the IPC API is only active when an editor is open. ## Available Tools ### General | Tool | Description | |---|---| | `get_kicad_version` | Get running KiCad version | | `get_open_documents` | List open schematic / PCB files | | `run_action` | Ex…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.