godot-ai

# Godot AI Godot AI는 Claude Code, Claude Desktop, Codex, Hermes Agent와 같은 MCP 클라이언트를 실행 중인 Godot 편집기에 연결합니다. 46개의 도구와 120개 이상의 작업을 제공하여 AI 어시스턴트가 씬을 구축하고, 노드와 스크립트를 편집하고, 시그널을 연결하고, UI, 머티리얼, 애니메이션, 파티클, 카메라, 환경을 구성할 수 있게 합니다. ## 빠른 시작 ### 요구 사항 - Godot AI v4용 Godot 4.7+ (4.x 계열 내) - uv (Python 서버용 uvx 제공) - MCP 클라이언트 ### 설치 1. **새 프로젝트:** GitHub Releases에서 게시된 버전을 다운로드하고 `plugin.cfg`가 포함된 `your-project/addons/godot_ai/` 디렉토리에 애드온을 설치합니다. 2. **기존 설치:** Godot AI 독의 업데이트 버튼을 사용합니다. 최종 서명된 v3 릴리스는 v4로의 원클릭 마이그레이션을 지원합니다. ### 플러그인 활성화 Godot에서: **프로젝트 → 프로젝트 설정 → 플러그인 → Godot AI**. 플러그인은 MCP 서버를 시작하고 Godot AI 독에 연결 상태를 표시합니다. ### MCP 클라이언트 연결 독에서 클라이언트 옆의 **구성**을 누르거나, 감지된 모든 클라이언트에 대해 **모두 구성**을 누릅니다. 지원되는 클라이언트에는 Claude Code, Claude Desktop, Codex, Antigravity, Hermes Agent, DeepSeek Harness, Cursor, VS Code가 포함됩니다. ### 사용해 보기 예시 프롬프트: - "현재 씬 계층 구조를 보여줘." - "/Main 아래에 MainCamera라는 Camera3D를 생성해." - "프로젝트에서 ui/의 PackedScene 파일을 검색해." - "씬 테스트 스위트를 실행해." - "플레이어, 배치 및 파괴 가능한 블록, 저장 슬롯이 있는 복셀 블록 월드 게임을 만들어." ## 작동 방식 ```text MCP 클라이언트 → godot-ai attach (stdio) → Python 서버 (인증된 HTTP, 포트 8000) → Godot 편집기 플러그인 (인증된 WebSocket, 포트 9500) ``` 두 로컬 홉 모두 독립적인 순환 자격 증명을 사용하며, 인증되지 않은 액세스로 대체되지 않습니다. 편집기 WebSocket은 루프백 전용으로 유지됩니다. 컨테이너나 다른 머신의 에이전트의 경우 편집기 머신에서 SSH를 통해 브리지를 실행합니다. ## 텔레메트리 및 개인정보 보호 사용 텔레메트리는 설치 UUID, 이벤트, 결과, 기간, 플랫폼, 버전을 기록하며, 코드, 씬 콘텐츠, 프로젝트/파일 이름은 기록하지 않습니다. 프로젝트 디렉토리 슬러그는 전송 전에 해시됩니다. `GODOT_AI_DISABLE_TELEMETRY=true` 또는 `DISABLE_TELEMETRY=true`로 옵트아웃할 수 있습니다. ## 문서 및 도움말 ### Bazzite / Fedora Atomic Desktop 문제 Bazzite 및 기타 Fedora Atomic 데스크톱에서 `/home`은 일반적으로 `/var/home`에 대한 심볼릭 링크입니다. Godot AI 4.0.2 이하 버전은 링크를 통과하는 모든 기능 디렉토리 경로를 거부합니다. 다음 릴리스는 링크가 루트 소유이고 다른 계정이 쓸 수 없는 루트 소유 디렉토리에 있는 경우 링크를 따릅니다. 4.0.2 이하 버전의 경우 `GODOT_AI_CAPABILITY_DIR`을 정규 경로로 설정하고 해당 터미널에서 Godot과 MCP 클라이언트를 모두 실행합니다. ### 참조 및 지원 - 도구, 작업, 리소스 - 게임 테스트 작성 및 실행 - 클라이언트 구성 세부 정보 - v3에서 업그레이드 및 중단된 마이그레이션 복구 - 변경 로그 - 기여 및 개발 설정 - 질문 및 쇼케이스용 Discord, 버그 신고용 GitHub Issues **라이선스:** MIT