프로젝트 소개

KiCad MCP Pro는 KiCad EDA 워크플로를 위해 구축된 오픈소스 Model Context Protocol 서버로, 모든 MCP 호환 AI 에이전트에 대해 회로도 설계, PCB 레이아웃, 검증, 제조 설계(DFM) 검사, 제조 내보내기 작업을 자동화하는 도구, 리소스, 프롬프트를 제공합니다. 이 서버는 점진적 공개(progressive disclosure)를 사용하여 기본 접근을 제한합니다. 24개의 읽기 전용 검토 도구를 포함하는 제한된 기본 프로필로 시작합니다. 추가 프로필은 통제된 기능을 해제합니다. build 프로필은 통제된 편집 작업을 활성화하고, release 프로필은 사람이 승인하는 핸드오프를 갖춘 제조 모드를 지원하며, expert/full 프로필은 고급 신뢰 클라이언트를 위해 예약되어 있습니다. 텔레메트리와 오류 보고는 기본적으로 비활성화되어 있으며, 선택적으로 옵트인 OpenTelemetry 구성을 사용할 수 있습니다. 이 프로젝트는 스스로를 자율적인 승인 권한이 아니라 전문적인 1차 설계 및 검토 보조 도구로 명확히 위치시킵니다. ERC 및 DRC 검사는 KiCad의 네이티브 엔진에서 직접 실행됩니다. 내장된 신호 무결성, 전력 무결성, EMC, 열 분석 도구는 일반적으로 5-10% 정확도의 1차 폐쇄형 추정치이며, 2D/3D 필드 솔버, EM/FEA 시뮬레이션 또는 공식 엔지니어링 승인을 대체하기 위한 것이 아니라 빠른 1차 검토를 위한 것입니다. 실시간 부품 소싱은 기본적으로 공개 JLCPCB 카탈로그를 사용하며, Nexar, DigiKey, Mouser 통합은 사용자가 유효한 API 자격 증명을 제공할 때만 사용할 수 있습니다. 이 서버는 문서화된 KiCad 프로그래매틱 기능 패리티를 76.6%로 추적하며, 이는 실제 기능 격차와 헤드리스 API가 없는 KiCad 기능을 구분하는 공개적으로 유지 관리되는 패리티 매트릭스를 통해 이루어집니다. 배포 옵션에는 공개된 PyPI 및 npm 패키지, http://127.0.0.1:3334/ui에서 로컬 웹 대시보드를 자동으로 실행하는 Tauri 데스크톱 애플리케이션, 초기화, 시스템 트레이 작동, 대시보드 실행, 서버 시작을 위한 명령이 있는 CLI가 포함됩니다. 지원되는 전송 프로토콜에는 stdio와 Streamable HTTP가 있으며, 세션 헤더가 필요 없는 커넥터를 지원하기 위해 기본적으로 무상태(stateless)로 작동합니다. 선택적 상태 유지 HTTP 모드와 레거시 SSE 폴백은 구형 클라이언트 호환성을 위해 사용할 수 있습니다. 이 저장소에는 Claude Code, Codex CLI, VS Code/GitHub Copilot, OpenCode를 위한 사전 구축된 MCP 구성 예제와 함께 설계 검토, PCB 레이아웃 검사 및 라우팅, ERC/DRC 실행 및 분류, 제조 출력 준비, 회로도 검토를 포함한 핵심 KiCad 워크플로를 위한 전용 스킬 정의가 포함되어 있습니다. 이 프로젝트는 MIT 라이선스이며, 전역 시스템 디렉터리를 수정하지 않고 체크섬으로 고정된 로컬 툴체인을 설치하는 재현 가능한 소스 부트스트랩 프로세스를 제공합니다. 기여 요구 사항에는 lint, format, typecheck, test, build, 보안 게이트 통과가 포함됩니다. 공개 문서 사이트에서는 설치, 클라이언트 구성, 도구 참조, 엔드투엔드 워크플로, 보안 위협 모델링, 오류 복구 지침을 다루며, 보관된 릴리스에는 학술 인용을 위한 영구 Zenodo DOI가 부여됩니다.