tugcantopaloglu/godot-mcp

해결하는 문제

Godot MCP는 AI 어시스턴트가 Godot 게임 엔진을 프로그래밍 방식으로 제어할 수 있게 해줍니다. LLM의 코드 작성 능력과 게임 프로젝트의 실제 실행, 검사 및 수정 사이의 간극을 메워 AI가 실시간으로 게임을 빌드, 디버그 및 테스트할 수 있도록 지원합니다.

작동 방식

이 프로젝트는 Model Context Protocol (MCP) 서버를 구현하여 157개의 전문 도구를 AI 어시스턴트에 노출합니다. 이러한 도구를 통해 AI는 두 가지 주요 모드로 Godot와 상호 작용할 수 있습니다.

1. 헤드리스 장면 작업 (Headless Scene Operations): 게임을 실행하지 않고도 .tscn 파일을 수정하고, 리소스를 생성하며, 프로젝트 설정을 관리합니다.
2. 런타임 상호 작용 (Runtime Interaction): TCP 기반 서버를 사용하여 게임이 활성화된 상태에서 GDScript 코드 (game_eval)를 실행하고, 노드 속성을 검사하며, 장면 트리를 조작하고, 사용자 입력(키보드, 마우스, 게임패드)을 시뮬레이션합니다.

GDScript와 .NET/C# 프로젝트를 모두 지원하며, 스크립트 검증 및 프로젝트 스캐폴딩 도구를 제공합니다.

대상 사용자

Godot 4.4+를 사용하는 게임 개발자 중 AI 에이전트를 활용하여 게임 제작을 자동화하고, 런타임 디버깅을 수행하거나 복잡한 장면 구조 및 로직을 생성하려는 분들.

주요 특징

• 광범위한 도구 세트: 3D/2D 렌더링, 물리, 오디오부터 네트워킹 및 UI 제어까지 아우르는 157개의 도구.
• 런타임 실행: 게임이 실행되는 동안 임의의 GDScript 코드를 실행하고 비동기 작업을 대기하는 기능.
• 심층적인 인트로스펙션: 런타임 시 완전한 노드 검사, 속성 읽기/쓰기 및 신호 관리.
• C# 지원: .NET 프로젝트 스캐폴딩 및 C# 스크립트 생성에 대한 일류 지원.
• 헤드리스 편집: 에디터를 실행하지 않고도 장면 파일과 프로젝트 설정을 구문 분석하고 수정하는 기능.
• 통합 진단: GDScript 구문 및 유형 오류를 헤드리스 방식으로 검증하는 도구.