better-godot-mcp은(는) 무엇을 하나요?
Godot 엔진용 복합 MCP 서버 — AI 기반 게임 개발을 위한 17개의 메가 도구
개요
n24q02m/better-godot-mcp는 Godot 엔진(4.x)을 위한 MCP(Model Context Protocol) 서버로, AI 어시스턴트가 Godot 에디터 및 프로젝트와 강력하고 직접적인 상호작용을 할 수 있도록 지원합니다. 17개의 포괄적인 도구를 통해 씬 조작, 스크립팅, 리소스 관리, 디버깅 등 다양한 작업을 자동화하고 가속화할 수 있습니다.
주요 기능
- 씬 및 노드 관리: 노드 추가, 제거, 속성 수정, 신호 연결
- 스크립트 분석 및 생성: GDScript 코드 검사, 분석, 템플릿 기반 생성
- 리소스 탐색: 프로젝트 리소스 검색, 임포트, 메타데이터 확인
- 에디터 제어: 에디터 명령 실행, 뷰포트 설정 변경
- 프로젝트 구성: 프로젝트 설정 읽기/쓰기, 오토로드 관리
지원 플랫폼
- Godot 4.x (권장: 4.3 이상)
- MCP 클라이언트 (Claude Desktop, Cursor, Continue.dev 등)
설치 및 설정
- 저장소를 클론하거나 복사합니다.
- 의존성을 설치합니다:
pip install -r requirements.txt(또는 해당 환경에 맞게) - MCP 서버를 실행합니다:
python server.py - MCP 클라이언트(예: Claude Desktop)에서 서버를 추가합니다.
도구 목록
다음은 제공되는 17개의 메가 도구입니다:
| 도구 이름 | 설명 |
|---|---|
create_scene | 새 씬 생성 |
add_node | 씬에 노드 추가 |
remove_node | 씬에서 노드 제거 |
get_scene_tree | 현재 씬 트리 가져오기 |
edit_node_property | 노드 속성 수정 |
connect_signal | 신호 연결 설정 |
disconnect_signal | 신호 연결 해제 |
list_script_methods | 스크립트 메서드 나열 |
run_gdscript | GDScript 코드 실행 |
generate_script | 템플릿에서 스크립트 생성 |
search_resources | 리소스 검색 |
import_resource | 리소스 가져오기 |
run_editor_command | 에디터 명령 실행 |
set_viewport_setting | 뷰포트 설정 변경 |
read_project_setting | 프로젝트 설정 읽기 |
write_project_setting | 프로젝트 설정 쓰기 |
list_autoloads | 오토로드 목록 보기 |
사용 예시
AI 어시스턴트에게 다음과 같이 요청할 수 있습니다:
- "씬에
Player노드를 추가하고CharacterBody3D타입으로 설정해줘." - "
Main씬의 스크립트에 있는 모든 메서드를 나열해줘." - "프로젝트 설정에서
application/config/name값을 읽어와." - "
res://scenes/Level1.tscn에서Enemy노드의speed속성을200으로 변경해줘."
참고 사항
- 모든 도구는 MCP 표준을 따르며, AI 클라이언트가 자동으로 해당 파라미터를 채웁니다.
- 보안상의 이유로,
run_gdscript도구는 신뢰할 수 있는 환경에서만 사용해야 합니다. - Godot 에디터는 서버 실행 중에 열려 있어야 합니다.
라이선스
MIT