{"id":49262946,"url":"https://github.com/oaslananka/kicad-mcp-pro","last_synced_at":"2026-05-10T14:03:54.103Z","repository":{"id":353445264,"uuid":"1208875830","full_name":"oaslananka/kicad-mcp-pro","owner":"oaslananka","description":"Professional Model Context Protocol server for KiCad: project setup, schematic/PCB tooling, validation, and manufacturing exports.","archived":false,"fork":false,"pushed_at":"2026-04-23T22:35:20.000Z","size":2951,"stargazers_count":76,"open_issues_count":0,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-04-24T00:25:51.514Z","etag":null,"topics":["ai","automation","bom","cad","circuit-design","eda","electronics","gerber","hardware","kicad","kicad-python","llm","manufacturing","mcp","mcp-server","model-context-protocol","pcb","pcb-design","python","schematic"],"latest_commit_sha":null,"homepage":"https://oaslananka.github.io/kicad-mcp-pro","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oaslananka.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["oaslananka"]}},"created_at":"2026-04-12T21:20:07.000Z","updated_at":"2026-04-23T22:40:48.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/oaslananka/kicad-mcp-pro","commit_stats":null,"previous_names":["oaslananka/kicad-mcp-pro"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/oaslananka/kicad-mcp-pro","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oaslananka%2Fkicad-mcp-pro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oaslananka%2Fkicad-mcp-pro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oaslananka%2Fkicad-mcp-pro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oaslananka%2Fkicad-mcp-pro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oaslananka","download_url":"https://codeload.github.com/oaslananka/kicad-mcp-pro/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oaslananka%2Fkicad-mcp-pro/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32256144,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-25T04:23:17.126Z","status":"ssl_error","status_checked_at":"2026-04-25T04:21:53.360Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","automation","bom","cad","circuit-design","eda","electronics","gerber","hardware","kicad","kicad-python","llm","manufacturing","mcp","mcp-server","model-context-protocol","pcb","pcb-design","python","schematic"],"created_at":"2026-04-25T08:39:03.708Z","updated_at":"2026-05-10T14:03:54.097Z","avatar_url":"https://github.com/oaslananka.png","language":"Python","funding_links":["https://github.com/sponsors/oaslananka","https://buymeacoffee.com/oaslananka"],"categories":[],"sub_categories":[],"readme":"# KiCad MCP Pro Server\n\n\u003c!-- mcp-name: io.github.oaslananka-lab/kicad-mcp-pro --\u003e\n\n[![PyPI](https://img.shields.io/pypi/v/kicad-mcp-pro.svg)](https://pypi.org/project/kicad-mcp-pro/)\n[![CI](https://github.com/oaslananka-lab/kicad-mcp-pro/actions/workflows/ci.yml/badge.svg)](https://github.com/oaslananka-lab/kicad-mcp-pro/actions/workflows/ci.yml)\n[![Docs](https://github.com/oaslananka-lab/kicad-mcp-pro/actions/workflows/docs.yml/badge.svg)](https://github.com/oaslananka-lab/kicad-mcp-pro/actions/workflows/docs.yml)\n[![Release](https://github.com/oaslananka-lab/kicad-mcp-pro/workflows/Release/badge.svg)](https://github.com/oaslananka-lab/kicad-mcp-pro/actions/workflows/release.yml)\n[![Codecov](https://codecov.io/gh/oaslananka-lab/kicad-mcp-pro/branch/main/graph/badge.svg)](https://codecov.io/gh/oaslananka-lab/kicad-mcp-pro)\n[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/oaslananka-lab/kicad-mcp-pro/badge)](https://scorecard.dev/viewer/?uri=github.com/oaslananka-lab/kicad-mcp-pro)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Python 3.12+](https://img.shields.io/badge/python-3.12%2B-blue.svg)](pyproject.toml)\n[![KiCad 10](https://img.shields.io/badge/KiCad-10-success.svg)](https://www.kicad.org)\n[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-oaslananka-yellow?logo=buy-me-a-coffee)](https://buymeacoffee.com/oaslananka)\n\nKiCad 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.\n\nUse it with Claude Desktop, Claude Code, Cursor, VS Code, Codex, or any MCP-compatible client.\n\nCanonical repository: https://github.com/oaslananka-lab/kicad-mcp-pro\n\nPersonal showcase mirror: https://github.com/oaslananka/kicad-mcp-pro\n\n## Quick Start\n\nInstall and run with `uvx`:\n\n```bash\nuvx kicad-mcp-pro --help\nuvx kicad-mcp-pro health --json\nuvx kicad-mcp-pro doctor --json\nuvx kicad-mcp-pro serve\n```\n\nOr install with `pip`:\n\n```bash\npip install kicad-mcp-pro\nkicad-mcp-pro --help\nkicad-mcp-pro health --json\nkicad-mcp-pro serve\n```\n\nThe default no-subcommand invocation still starts the stdio MCP server for\nbackward compatibility. `health --json` is safe to run when KiCad is not\nrunning; it reports KiCad IPC as deferred instead of crashing. `doctor --json`\nadds deeper CLI and IPC diagnostics for launchers such as `kicad-studio`.\n\n## Minimal MCP Config\n\nUse an absolute KiCad project path:\n\n```json\n{\n  \"servers\": {\n    \"kicad\": {\n      \"type\": \"stdio\",\n      \"command\": \"uvx\",\n      \"args\": [\"kicad-mcp-pro\"],\n      \"env\": {\n        \"KICAD_MCP_PROJECT_DIR\": \"/absolute/path/to/your/kicad-project\",\n        \"KICAD_MCP_WORKSPACE_ROOT\": \"/absolute/path/to/your/workspace\",\n        \"KICAD_MCP_PROFILE\": \"pcb_only\"\n      }\n    }\n  }\n}\n```\n\nMore client examples:\n\n- [Client configuration](docs/client-configuration.md)\n- [Claude Desktop](docs/integration/claude-desktop.md)\n- [Cursor](docs/integration/cursor.md)\n- [Claude Code](docs/integration/claude-code.md)\n- [KiCad Studio](docs/integration/kicad-studio.md)\n\n## What It Does\n\n- Project-aware setup with safe path handling and recent-project discovery.\n- PCB tools for board state, tracks, vias, footprints, layers, zones, placement, and sync.\n- Schematic tools for symbols, wires, labels, buses, annotation, templates, routing, and IPC reload.\n- Validation gates for schematic quality, connectivity, PCB quality, placement, transfer, DFM, and manufacturing.\n- Gated release handoff through `export_manufacturing_package()`.\n- Export tools for Gerber, drill, BOM, PDF, netlist, STEP, render, pick-and-place, IPC-2581, SVG, and DXF.\n- SI, PI, EMC, routing, simulation, library, and version-control helper surfaces.\n- Server profiles such as `minimal`, `pcb_only`, `schematic_only`, `manufacturing`, `analysis`, and `agent_full`.\n- Machine-readable CLI diagnostics for editors and MCP clients.\n\n## Capability Status\n\nCapabilities are verified at different levels depending on test coverage and runtime dependencies.\nSee [Capability Verification Levels](docs/status/capability-levels.md) for the current truth table.\n\n## Common Workflow\n\n```text\nkicad_set_project()\nproject_get_design_spec()\nsch_build_circuit()\npcb_sync_from_schematic()\nproject_quality_gate_report()\nexport_manufacturing_package()\n```\n\nDemo media guidance lives in [docs/demo-media.md](docs/demo-media.md).\n\n## Documentation\n\n- [Installation](docs/installation.md)\n- [Configuration](docs/configuration.md)\n- [Tools reference](docs/tools-reference.md)\n- [Troubleshooting](docs/troubleshooting.md)\n- [FAQ](docs/faq.md)\n- [API stability](docs/api-stability.md)\n- [Release process](docs/release-process.md)\n- [Maintenance policy](docs/maintenance-policy.md)\n- [Workflow security](docs/workflow-security.md)\n- [Publishing](docs/publishing.md)\n- [Release integrity](docs/security/release-integrity.md)\n- [Docker install](docs/install/docker.md)\n- [Client config generator](docs/install/client-config-generator.md)\n- [Security threat model](docs/security/threat-model.md)\n- [Architecture decisions](docs/adr/README.md)\n- [Comparison](docs/comparison.md)\n\n## Repository Operations\n\nNormal CI and security workflows run on pull requests, pushes, and merge queue\nevents. Release, publish, mirroring, deployment, and token-backed jobs remain\nguarded behind explicit repository checks and protected environments.\n\nThe project uses Dependabot, Renovate, CodeQL, Gitleaks, Trivy, OpenSSF\nScorecard, Codecov, release-please, SBOM generation, Sigstore signing, and\nGitHub artifact attestations for release hardening.\n\nOperational references:\n\n- [Repository operations](docs/repository-operations.md)\n- [Publishing](docs/publishing.md)\n- [Autonomy model](docs/autonomy.md)\n- [Doppler setup](docs/doppler-setup.md)\n- [Branch protection](docs/branch-protection.md)\n\n## Contributing and Support\n\n- [Contributing](CONTRIBUTING.md)\n- [Support](SUPPORT.md)\n- [Governance](GOVERNANCE.md)\n- [Security policy](SECURITY.md)\n- [Roadmap](ROADMAP.md)\n- [Changelog](CHANGELOG.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foaslananka%2Fkicad-mcp-pro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foaslananka%2Fkicad-mcp-pro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foaslananka%2Fkicad-mcp-pro/lists"}