hi-godot/godot-ai

해결하는 문제

Godot AI는 AI 어시스턴트(예: Claude Code 또는 Codex)가 실시간 Godot 게임 엔진 에디터와 직접 상호작용할 수 있도록 합니다. 사용자가 AI 채팅과 엔진 간에 코드나 장면 설정을 수동으로 복사-붙여넣기할 필요 없이, AI가 실시간으로 장면을 프로그래밍으로 구축하고, 노드를 편집하며 게임 환경을 구성할 수 있게 해줍니다.

작동 방식

이 프로젝트는 AI 클라이언트와 Godot 에디터 사이의 격차를 메우기 위해 Model Context Protocol (MCP)를 사용합니다. Python 서버(FastMCP 사용)가 중개자 역할을 하며 WebSockets를 통해 Godot 에디터 플러그인에 연결됩니다. AI 클라이언트는 HTTP 또는 stdio 브리지를 통해 이 서버와 통신하여 43개의 도구를 통해 120개 이상의 작업을 트리거할 수 있습니다. 예를 들어 노드 생성, 시그널 연결, 스크립트 편집 등이 가능합니다.

대상 사용자

Godot Engine(버전 4.5 이상)을 사용하고 있으며, UI 레이아웃, 장면 조립, 기본 스크립팅과 같은 게임 개발의 반복적인 작업을 AI 에이전트로 자동화하고 싶은 게임 개발자들.

주요 특징

• 심층적인 에디터 통합: 전체 장면 구축, 재질, 애니메이션, 입자, 카메라 설정을 프로그래밍으로 가능.
• 광범위한 클라이언트 호환성: Claude Code, Claude Desktop, Cursor, Zed 등 다양한 MCP 클라이언트와 호환.
• 코드에서 완전히 구현된 UI: 외부 이미지 생성 없이도 복잡한 UI를 프로그래밍으로 그릴 수 있음.
• 통합 테스트 기능: 에디터 내부에 GDScript 테스트 프레임워크가 내장되어 있어 AI 클라이언트가 게임용 테스트 세트를 작성하고 실행할 수 있음.