tomyud1/godot-mcp

해결하는 문제

이 프로젝트는 AI 어시스턴트(Claude 또는 Cursor 등)와 Godot 게임 엔진 에디터 사이의 다리를 제공합니다. AI가 에디터의 장면, 스크립트, 프로젝트 설정에 직접 접근할 수 있게 함으로써, 코드와 컨텍스트를 수동으로 복사-붙여넣기하거나 작업 전환하는 번거로움을 제거합니다.

작동 방식

Model Context Protocol (MCP)를 사용하여 AI 클라이언트를 Node.js 서버에 연결하고, 이 서버는 WebSockets를 통해 Godot 에디터 플러그인과 통신합니다. 이 아키텍처를 통해 AI는 게임 프로젝트를 조작할 수 있는 다양한 도구를 실행할 수 있습니다.

대상 사용자

Godot 4.x를 사용하는 게임 개발자 중에서 AI 에이전트를 활용해 반복 작업을 자동화하고, 스크립트를 작성하며, 에디터 내에서 프로젝트 구조를 직접 관리하고 싶은 분들.

주요 특징

• 풍부한 도구 세트: 파일 작업, 장면 조작, 스크립트 편집, 프로젝트 관리 등 42개의 도구를 포함.
• 인터랙티브 시각화 도구: 브라우저 기반 도구로 스크립트와 그 관계를 힘 기반 그래프로 시각화하여 실시간 코드 편집과 장면 그래프 탐색이 가능.
• 에디터 직접 통합: AI는 파일 읽기/쓰기, 장면 생성, 노드 추가/제거, 텍스처 할당이 가능하며, 전용 도구를 통해 되돌리기/다시하기 기능도 지원.
• 광범위한 클라이언트 호환성: Claude Desktop, Cursor, Claude Code를 포함한 모든 MCP 호환 AI 클라이언트와 호환됩니다.