KiCAD MCP Server

KiCAD MCP Server는 Claude와 같은 AI 어시스턴트가 PCB 설계를 자동화하기 위해 KiCAD와 상호작용할 수 있도록 지원하는 Model Context Protocol (MCP) 서버입니다. MCP 2025-06-18 사양을 기반으로 구축된 이 서버는 지능적인 PCB 설계 워크플로우를 위해 포괄적인 도구 스키마 (tool schemas) 및 실시간 프로젝트 상태 액세스를 제공합니다.

무엇을 만들고 싶은지 설명하기만 하면 AI가 EDA 작업을 처리합니다. AI 어시스턴트와 대화하는 것만으로 부품 배치, 커스텀 심볼 (symbols) 및 풋프린트 (footprints) 생성, 배선 (routing), 검사 실행, 생산 파일 내보내기를 수행할 수 있습니다.

• 프로젝트 설정, 회로도 편집, 부품 배치, 배선, DRC/ERC, 내보내기
  커스텀 심볼 및 풋프린트 생성— 표준 KiCAD 라이브러리에 없는 모듈용
  개인 라이브러리 관리— 한 번 생성하여 여러 프로젝트에서 재사용
  JLCPCB 통합— 가격 및 재고 데이터가 포함된 부품 카탈로그
  Freerouting 통합— Java/Docker를 통한 자동 PCB 배선
  시각적 피드백— 추적성을 위한 스냅샷 및 세션 로그
  크로스 플랫폼— Windows, Linux, macOS

• KiCAD 9.0+ 설치

• Node.js 18+ 및 Python 3.11+ 설치

• 클론 및 빌드:

git clone https://github.com/mixelpixx/KiCAD-MCP-Server.git
cd KiCAD-MCP-Server
npm install
...

• AI 클라이언트 설정 — Platform Guide 참조

config/vscode-mcp.example.json을

.vscode/mcp.json으로 복사하세요

— VS Code가 이를 자동으로 감지합니다. → 전체 설정 가이드 (Full setup guide)

설정 파일 편집:

Windows: %APPDATA%\Claude\claude_desktop_config.json

macOS/Linux: ~/.config/claude/claude_desktop_config.json

설정 예시: config/windows-config.example.json 또는 config/macos-config.example.json

전체 README— 전체 문서

• Quick Start (Router Tools) — 첫 단계

• Tool Inventory — 사용 가능한 모든 도구

• Schematic Tools Reference — 회로도 도구 참조

• Routing Tools Reference — 배선 도구 참조

• Footprint & Symbol Creator Guide — 풋프린트 및 심볼 생성기 가이드

• JLCPCB Usage Guide — JLCPCB 사용 가이드

• Platform Guide — 플랫폼 가이드

• Changelog — 변경 이력

• Discussions — 질문, 아이디어, 쇼케이스

• Issues — 버그 및 기능 요청

• Contributing — 기여하기

AI 지원으로 개발됨
이 프로젝트는 AI 지원 코딩 도구(GitHub Copilot, Claude)의 도움을 받아 개발되었습니다. 모든 코드는 유지 관리자(maintainers)에 의해 검토, 테스트 및 통합되었습니다. AI 도구는 개발 속도를 높이기 위해 사용되었으며, 창의적인 결정, 아키텍처 및 책임은 전적으로 저자에게 있습니다.

보증 없음 — 사용자의 책임
이 프로젝트는 명시적이든 묵시적이든 어떠한 보증 없이 제공됩니다. 저자와 기여자들은 다음을 포함하되 이에 국한되지 않는, 본 소프트웨어의 사용 또는 사용 불능으로 인해 발생하는 모든 종류의 손해에 대해 어떠한 책임도 지지 않습니다:

• 생성된 회로도(schematics), PCB 레이아웃 또는 제조 파일의 오류
• 잘못된 설계로 인한 하드웨어, 부품 또는 장치의 손상
• 제조 오류 또는 잘못된 주문으로 인한 금전적 손실
• KiCAD 프로젝트 파일의 데이터 손실 또는 손상

AI가 생성한 설계 제안은 자격을 갖춘 엔지니어링 검토를 대체할 수 없습니다. 안전이 중요한 애플리케이션(의료, 항공우주, 자동차 등)은 반드시 독립적인 전문가의 검증이 필요합니다.

이 프로젝트는 MIT 라이선스(MIT License) 하에 라이선스가 부여되며, 이 라이선스 역시 모든 책임을 제외합니다.