hi-godot/godot-ai

해결하는 문제

Godot AI는 AI 어시스턴트(Claude Code, Claude Desktop, Cursor 등)가 라이브 Godot 게임 엔진 에디터와 직접 상호작용할 수 있게 합니다. 이를 통해 사용자가 코드를 수동으로 복사-붙여넣기하거나 씬을 수동으로 설정할 필요가 없어지며, AI가 실시간으로 씬을 구축하고, 노드를 편집하고, 게임 환경을 구성할 수 있습니다.

작동 방식

이 프로젝트는 Model Context Protocol(MCP)을 구현하여 AI 클라이언트와 Godot 에디터 사이의 브리지 역할을 합니다. 통신 흐름은 다음과 같습니다:

1. MCP 클라이언트: AI 어시스턴트(예: Claude)가 요청을 보냅니다.
2. 브리지: Python 서버(godot-ai attach)가 stdio를 통해 요청을 처리합니다.
3. Godot 에디터: Godot 에디터 내의 플러그인이 인증된 WebSocket 연결을 수신하고 작업을 실행합니다.

스크립트 편집, 신호 연결, UI 구성을 포함하여 에디터를 조작하는 46개의 도구와 120개 이상의 작업을 제공합니다.

대상 사용자

Godot Engine(4.7+)을 사용하는 게임 개발자로서, 씬 구축, 머티리얼 구성, 플레이어 컨트롤러 설정과 같은 에디터 기반 게임 개발의 반복적인 작업을 자동화하기 위해 LLM을 활용하려는 개발자를 대상으로 합니다.

주요 특징

• 깊은 에디터 통합: 씬 구축, 노드 편집, 신호 연결, UI, 머티리얼, 애니메이션, 파티클 구성이 가능합니다.
• 광범위한 클라이언트 지원: Claude Code, Claude Desktop, Codex, Cursor, VS Code 등과 호환됩니다.
• 광범위한 스크립팅 지원: 파싱 검증 및 핫 리로딩을 통한 GDScript 완전 지원, C# 텍스트 전용 지원.
• 안전한 통신: 독립적인 회전 기능과 인증된 HTTP/WebSocket 연결을 사용하여 로컬 루프백 보안을 보장합니다.

SUMMARY: MCP 호환 AI 어시스턴트를 Godot 에디터에 연결하는 브리지로, AI가 엔진에서 직접 씬을 구축하고, 노드를 편집하고, 스크립트를 작성할 수 있게 합니다.

TITLE: AI 어시스턴트가 Godot 게임 엔진 에디터를 직접 조작할 수 있게 하는 MCP 기반 브리지