프로젝트 소개

Breakpoint MCP는 AI 어시스턴트(Claude 등)를 Godot 게임 엔진(4.2+)에 연결하기 위해 설계된 Model Context Protocol 서버입니다. 단순한 제작 도구와 달리, Godot의 내장 Language Server Protocol(LSP) 및 Debug Adapter Protocol(DAP)의 완전한 클라이언트로 작동하여, AI 에이전트가 GDScript와 C# 모두에 대해 중단점 설정, 코드 단계별 실행, 실제 프로그램 상태 검사 등 심층적인 기술 작업을 수행할 수 있도록 합니다. 이 서버는 네 가지 기능 평면으로 구성됩니다: - Plane A (Live Editor): 에디터 플러그인을 통해 전체 실행 취소/다시 실행을 지원하는 씬/노드/리소스 CRUD 작업을 처리합니다. - Plane B (Headless CLI): 프로젝트 실행, 내보내기, 가져오기 및 버전 관리(Git) 작업을 관리합니다. - Plane C (Runtime Bridge): 실행 중인 게임의 SceneTree에 대한 라이브 액세스, 속성 조작 및 런타임 검증(어설션 및 스크린샷 차이 분석)을 제공합니다. - Plane D (Semantic & Debugging): GDScript 및 C#을 위한 자동 완성, 진단 및 전체 단계별 디버거를 제공합니다. 주요 특징으로는 고위험 도구가 기본적으로 비활성화되는 보안 우선 신뢰 모델, 루프백 소켓을 통한 로컬 전용 통신, 그리고 AI 모델의 토큰 오버헤드를 줄이기 위해 특정 도구 세트만 로드할 수 있는 기능 등이 포함됩니다.