KiCAD-MCP-Server

KiCAD MCP Server
🇺🇸 English (EN) • 🇩🇪 Deutsch (DE) • 🇨🇳 中文 (ZH)

새 포럼이 열렸습니다: https://forum.orchis.ai — 도움이 필요하신가요? 제안이 있으신가요? 작업물을 자랑하고 싶으신가요?

Konnect를 만나보세요 — 차세대 버전
Konnect는 이 프로젝트를 Rust로 처음부터 다시 구현한 네이티브 KiCAD 10 플러그인입니다. 런타임 의존성이 없는 단일 바이너리로, SWIG 대신 KiCAD의 공식 IPC API를 기반으로 하며, 171개의 도구, 번들된 Claude 스킬과 에이전트, 설계 검토 감사, 제조 파이프라인을 갖추고 있습니다. 새로운 개발이 이루어지는 곳입니다 — AGPL-3.0 라이선스(개인 및 오픈 소스는 무료, 기업용 상용 라이선스 제공).

이 Python/TypeScript 서버는 완전히 오픈(MIT) 상태로 유지·관리됩니다.

KiCAD MCP와 Konnect는 Nimrod와 잘 작동합니다
Nimrod는 저희의 웹 리서치 MCP 서버입니다: 품질 점수가 매겨진 Google 검색, 깔끔한 웹페이지 추출, 심층 다중 소스 리서치를 제공합니다. Konnect로 보드를 설계하는 동안 Nimrod가 실시간 부품 가용성, 데이터시트, 정오표를 가져옵니다 — 더 이상 1년 된 학습 데이터로 추측할 필요가 없습니다.

claude.ai, Claude Desktop, Claude Code, VS Code 및 모든 MCP 클라이언트와 호환됩니다
1 크레딧 = 1 검색 · 추출은 항상 무료 · 카드 없이 50 크레딧 무료 체험
공식 MCP Registry: ai.orchis/nimrod

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

자연어로 PCB 설계하기
만들고 싶은 것을 설명하세요 — EDA 작업은 AI가 처리합니다. AI 어시스턴트와 대화만으로 컴포넌트 배치, 커스텀 심볼과 풋프린트 생성, 연결 라우팅, 검사 실행, 생산 파일 내보내기를 모두 할 수 있습니다.

현재 할 수 있는 일

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

빠른 시작

KiCAD 9.0+ 설치
Node.js 18+ 및 Python 3.11+ 설치
클론 및 빌드:

git clone --branch stable https://github.com/mixelpixx/KiCAD-MCP-Server.git
cd KiCAD-MCP-Server
npm install
npm run build
stable은 최신 릴리스이며, main에는 아직 릴리스되지 않은 수정 사항도 포함되어 있습니다.

AI 클라이언트 구성 — Platform Guide 참고

GitHub Copilot (VS Code)
config/vscode-mcp.example.json을 .vscode/mcp.json으로 복사하세요 — VS Code가 자동으로 감지합니다. → 전체 설정 가이드

Claude Desktop
구성 파일을 편집하세요:

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 — 완전한 문서
빠른 시작 (라우터 도구) — 첫 단계
도구 목록 — 사용 가능한 모든 도구
회로도 도구 레퍼런스
라우팅 도구 레퍼런스
풋프린트 및 심볼 생성 가이드
JLCPCB 사용 가이드
플랫폼 가이드
변경 로그

커뮤니티

토론 — 질문, 아이디어, 쇼케이스
이슈 — 버그 및 기능 요청
기여하기

Star History

AI 고지

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

면책 조항

보증 없음 — 사용에 따른 위험은 본인 책임

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

생성된 회로도, PCB 레이아웃 또는 제조 파일의 오류
잘못된 설계로 인한 하드웨어, 컴포넌트 또는 장치 손상
제조 오류 또는 잘못된 주문으로 인한 재정적 손실
KiCAD 프로젝트 파일의 데이터 손실 또는 손상

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

이 프로젝트는 MIT License에 따라 라이선스가 부여되며 — 이 역시 모든 책임을 배제합니다.