IvanMurzak/Godot-MCP

해결하는 문제

Godot-MCP는 AI 에이전트와 Godot 게임 엔진 사이의 간극을 메웁니다. 개발자는 Claude, Cursor 또는 GitHub Copilot과 같은 AI 어시스턴트를 사용하여 Godot 프로젝트를 직접 검사, 수정 및 관리할 수 있으며, 수동으로 에디터를 조작해야 했던 작업을 자동화할 수 있습니다.

작동 방식

C# 에디터 애드온으로 작동하며 Model Context Protocol(MCP)을 통해 Godot 에디터 작업을 "AI 도구"로 노출합니다. Godot 프로젝트를 MCP 지원 에이전트에 연결하면 AI는 RQL이라는 특수 쿼리 언어를 사용하여 노드 생성, 장면 편집, 리소스 관리, C# 및 GDScript 코드 실행과 같은 작업을 수행할 수 있습니다. 클라우드 기반 및 자체 호스팅 설정을 모두 지원하며 설치 및 프로젝트 구성을 단순화하는 명령줄 인터페이스(godot-cli)가 포함되어 있습니다.

대상 사용자

이 도구는 C#/.NET 버전(4.3+)을 사용하는 Godot 개발자를 위해 설계되었으며, 게임 개발 워크플로우에 AI 에이전트를 통합하여 장면 구축, 스크립트 관리 및 디버깅을 가속화하려는 사용자를 대상으로 합니다.

주요 기능

• 광범위한 AI 호환성: Claude, Cursor, Copilot과 같은 주요 AI 에이전트와 호환되며 벤더 종속이 없습니다.
• RQL 통합: 강력한 리플렉션 쿼리 언어(RQL)를 사용하여 장면 트리, 속성 및 프로젝트 설정을 일괄적으로 쿼리하고 변경합니다.
• 다중 언어 지원: C# 및 GDScript 파일을 읽고, 생성하고, 업데이트할 수 있습니다.
• 시각적 피드백: AI가 뷰포트, 카메라 또는 격리된 노드의 스크린샷을 캡처하여 게임 상태를 더 잘 이해할 수 있도록 합니다.
• 런타임 진단: 게임 내 런타임 오류 및 로그를 캡처하고 폴링하는 도구를 제공하여 AI가 플레이테스트 중 문제를 디버깅하는 데 도움을 줍니다.