프로젝트 소개

godot-mcp-bridge는 Claude 및 Cursor와 같은 AI 클라이언트를 Godot 4 에디터에 직접 통합하도록 설계된 MCP(Model Context Protocol) 서버입니다. 단방향 서버와 달리 양방향 방식을 채택하여, AI가 사용자의 에디터 활동(선택, 저장 등)을 실시간으로 추적할 수 있습니다. 주요 기능은 다음과 같습니다: - 라이브 트리 편집(Live-Tree Editing): 디스크의 파일을 덮어쓰는 대신 활성 에디터 트리를 변경하여 저장되지 않은 변경 사항을 보존하고 Godot의 실행 취소(undo) 시스템을 지원합니다. - 디버깅 및 테스트: Godot의 Debug Adapter를 통한 스텝 디버거(중단점, 스택 추적, 변수 평가)와 GUT 유닛 테스트 스위트 통합을 포함합니다. - 광범위한 도구 모음: core, runtime, debug, code_intel 등 도구 세트로 분류된 231개의 도구를 제공하며, GDScript LSP 기반 리팩토링 및 씬 스캐폴딩부터 멀티플레이어 진단 및 비동기 헤드리스 내보내기까지 모든 기능을 다룹니다. - 런타임 제어: 입력 시뮬레이션, 시그널 대기 및 텍스트를 통한 UI 상호작용으로 실행 중인 게임을 구동할 수 있는 능력을 제공합니다. - 프로젝트 분석: 순환 종속성 감지, 미사용 리소스 확인 및 시그널 흐름 분석 도구를 제공합니다. - 시각화 도구(Visualizer): 스크립트 관계를 매핑하고 코드 및 속성을 편집할 수 있는 브라우저 기반의 대화형 탐색기를 제공합니다. 이 시스템은 WebSockets를 통해 Godot 에디터 플러그인과 통신하는 Node.js 사이드카로 작동하며, stdio 및 HTTP 클라이언트를 모두 지원합니다.