pcb-mcp
Enables AI assistants to read and modify KiCAD PCB designs through the KiCAD IPC API, providing tools for board queries, footprint placement, track creation, DRC, and export.
README
pcb-mcp
An MCP server that lets an AI assistant read and modify KiCAD PCB designs through KiCAD's IPC API.
Status
Pre-alpha. There is no working code yet. This is actively being built as a personal learning project and is not usable today. It is not installable.
What it will do
The server exposes a small set of tools (20 or fewer) so an AI assistant can pick the right one reliably:
- Query board state (layers, nets, footprints, tracks, zones)
- Place and move footprints
- Create tracks and vias
- Run Design Rule Check (DRC)
- Export manufacturing files (Gerbers, drill files, BOM)
Design decisions
| Choice | Reason |
|---|---|
| Python 3.11+ | Matches KiCAD plugin ecosystem, broad library support |
Official mcp SDK v2 (MCPServer, stdio transport) |
Canonical implementation, stable as of 2026-07-28 |
kicad-python over the KiCAD IPC API |
MIT-licensed, actively maintained, replaces deprecated SWIG pcbnew bindings |
| KiCAD 10.0.x target | Current stable (10.0.5). IPC API first shipped in KiCAD 9 but matured in 10 |
| PCB editor scope only | The IPC API has no schematic access today |
| MIT license (out-of-process client) | No GPL entanglement because the server communicates over IPC, not linked to KiCAD |
Requirements
- KiCAD 10.0.x installed and running with a board open. The IPC API needs a live GUI instance (headless mode is expected in KiCAD 11).
- KiCAD API enabled in Preferences → API settings.
- Python 3.11+
- Only one IPC client can attach to a KiCAD instance at a time.
Development
This project follows a branch-and-pull-request workflow. The main branch is protected, and every change lands through a PR.
Detailed planning and research documents are kept locally and are not published in this repo. The README is the single source of project context for external readers.
License
MIT. See LICENSE.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.