youichi-uda/godot-mcp-pro

해결하는 문제

Godot MCP Pro는 AI 어시스턴트(예: Claude)와 Godot 게임 엔진 에디터 사이의 다리를 제공합니다. AI가 에디터를 직접 조작하고, 씬을 관리하며, 스크립트를 작성하고, 게임 입력을 시뮬레이션할 수 있게 해주어 개발자가 수동으로 코드를 복사-붙여넣기하거나, 노드와 속성을 수동으로 설정할 필요가 없게 됩니다.

작동 방식

이 시스템은 3계층 아키텍처를 사용합니다. AI 어시스턴트는 Model Context Protocol (MCP)를 통해 Node.js 서버에 연결하고, 서버는 WebSockets를 통해 Godot 에디터 플러그인과 통신합니다. 이 구조는 실시간 피드백과 Godot의 에디터 API(되돌리기/재실행 시스템 포함)에 대한 완전한 접근을 가능하게 하여 AI가 생성한 변경 사항을 쉽게 되돌릴 수 있습니다.

대상 사용자

LLM을 개발 워크플로우에 통합하여 반복적인 작업을 자동화하거나, 프로그래밍으로 씬을 구축하거나, 여러 씬에 걸쳐 복잡한 리팩터링을 수행하고자 하는 Godot 엔진 사용자.

주요 특징

• 거대한 도구 세트: 애니메이션, TileMaps, 쉐이더, 물리, 오디오 등 다양한 카테고리에 걸쳐 175개의 도구 포함.
• 런타임 인스펙션: 실행 중인 게임의 씬 트리와 속성을 확인할 수 있습니다.
• 입력 시뮬레이션: 키보드, 마우스, 액션 시퀀스를 시뮬레이션하여 게임 메커니즘을 테스트할 수 있습니다.
• 에디터 통합: 에디터 뷰포트와 실행 중인 게임의 스크린샷 캡처를 지원합니다.
• 유연한 모드: AI 클라이언트의 도구 제한에 맞춰 Full, 3D, Lite, Minimal 모드를 제공합니다.
• CLI 대체 옵션: MCP를 지원하지 않는 클라이언트나 컨텍스트 오버헤드를 줄이고자 할 때 사용 가능한 CLI 모드 포함.