Main
Run
health --jsonanddoctor --jsonbefore 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
uvxquick start includinghealth --json,doctor --json, andservecommands. - README states
health --jsonis 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.