kicad-mcp-pro

Name: kicad-mcp-pro
Author: oaslananka

Warning

MCP server for KiCad 10/9 — schematic capture, PCB layout, DRC/ERC/DFM, signal & power integrity, EMC, SPICE simulation, FreeRouting, and Gerber/BOM/IPC-2581/STEP exports via AI agents.

117stars

12forks

Python

Added 4/30/2026

View on GitHub Download ZIP Scan for vulnerabilities

AI Agentsaiautomationdfmedaelectronics

Installation

# Add to your Claude Code skills
git clone https://github.com/oaslananka/kicad-mcp-pro

Getting Started

Guides for using ai agents skills like kicad-mcp-pro.

Security ReportWarning

Last scanned: 5/30/2026

{
  "issues": [
    {
      "type": "clone-failed",
      "message": "Could not clone repository",
      "severity": "medium"
    }
  ],
  "status": "WARNING",
  "scannedAt": "2026-05-30T16:30:47.666Z",
  "npmAuditRan": false,
  "pipAuditRan": false
}

README.md

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

215,057

go-utcp mcp-image

KiCad MCP Pro Server

KiCad MCP Pro is a Model Context Protocol server for KiCad PCB and schematic workflows. It gives agents project setup, schematic editing, PCB inspection and edits, validation gates, DFM checks, SI/PI helpers, simulation helpers, and release-gated manufacturing export.

Use it with Claude Desktop, Claude Code, Cursor, VS Code, Codex, or any MCP-compatible client.

Canonical repository: https://github.com/oaslananka-lab/kicad-mcp-pro

Personal showcase mirror: https://github.com/oaslananka/kicad-mcp-pro

Quick Start

Install and run with uvx:

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

Or install with pip:

pip install kicad-mcp-pro
kicad-mcp-pro --help
kicad-mcp-pro health --json
kicad-mcp-pro serve

The default no-subcommand invocation still starts the stdio MCP server for backward compatibility. health --json is safe to run when KiCad is not running; it reports KiCad IPC as deferred instead of crashing. doctor --json adds deeper CLI and IPC diagnostics for launchers such as kicad-studio.

Minimal MCP Config

Use an absolute KiCad project path:

{
  "servers": {
    "kicad": {
      "type": "stdio",
      "command": "uvx",
      "args": ["kicad-mcp-pro"],
      "env": {
        "KICAD_MCP_PROJECT_DIR": "/absolute/path/to/your/kicad-project",
        "KICAD_MCP_WORKSPACE_ROOT": "/absolute/path/to/your/workspace",
        "KICAD_MCP_PROFILE": "pcb_only"
      }
    }
  }
}

More client examples:

What It Does

Project-aware setup with safe path handling and recent-project discovery.
PCB tools for board state, tracks, vias, footprints, layers, zones, placement, and sync.
Schematic tools for symbols, wires, labels, buses, annotation, templates, routing, and IPC reload.
Validation gates for schematic quality, connectivity, PCB quality, placement, transfer, DFM, and manufacturing.
Gated release handoff through export_manufacturing_package().
Export tools for Gerber, drill, BOM, PDF, netlist, STEP, render, pick-and-place, IPC-2581, SVG, and DXF.
SI, PI, EMC, routing, simulation, library, and version-control helper surfaces.
Server profiles such as minimal, pcb_only, schematic_only, manufacturing, analysis, and agent_full.
Machine-readable CLI diagnostics for editors and MCP clients.

Capability Status

Capabilities are verified at different levels depending on test coverage and runtime dependencies. See Capability Verification Levels for the current truth table.

Common Workflow

kicad_set_project()
project_get_design_spec()
sch_build_circuit()
pcb_sync_from_schematic()
project_quality_gate_report()
export_manufacturing_package()

Demo media guidance lives in docs/demo-media.md.

Documentation

Repository Operations

Normal CI and security workflows run on pull requests, pushes, and merge queue events. Release, publish, mirroring, deployment, and token-backed jobs remain guarded behind explicit repository checks and protected environments.

The project uses Dependabot, Renovate, CodeQL, Gitleaks, Trivy, OpenSSF Scorecard, Codecov, release-please, SBOM generation, Sigstore signing, and GitHub artifact attestations for release hardening.

Operational references: