Skip to main content
Glama
deenesjakoruzh
n24q02m

Better Godot MCP

by n24q02m
OverviewSchemaRelated ServersScoreDiscussions
TypeScript

Better Godot MCP

mcp-name: io.github.n24q02m/better-godot-mcp

Godot 엔진을 위한 복합 MCP 서버 -- AI 보조 게임 개발을 위한 17개의 메가 도구

CI codecov npm Docker License: MIT

TypeScript Node.js Godot Engine semantic-release Renovate

기능

  • 17개의 복합 메가 도구 -- 씬, 노드, 스크립트, 셰이더, 애니메이션, 타일맵, 물리, 오디오, 내비게이션, UI 등

  • 전체 씬 제어 -- Godot 실행 없이 .tscn 파일을 직접 생성, 파싱 및 수정

  • GDScript CRUD -- 단일 호출로 스크립트 생성, 읽기, 쓰기 및 연결

  • 계층적 토큰 최적화 -- 압축된 설명 + 온디맨드 help 도구

Related MCP server: WET - Web Extended Toolkit

설정

AI 에이전트 사용 시 -- 다음 내용을 복사하여 AI 에이전트에게 전송하세요:

Please set up @n24q02m/better-godot-mcp for me. Follow this guide: https://raw.githubusercontent.com/n24q02m/better-godot-mcp/main/docs/setup-with-agent.md

수동 설정 -- docs/setup-manual.md를 따르세요.

도구

도구

작업

설명

project

info, version, run, stop, settings_get, settings_set, export

프로젝트 메타데이터, 실행/중지 및 설정

scenes

create, list, info, delete, duplicate, set_main

씬 파일 관리

nodes

add, remove, rename, list, set_property, get_property

씬 트리 노드 조작

scripts

create, read, write, attach, list, delete

GDScript 파일 CRUD

editor

launch, status

Godot 에디터 실행 및 상태 확인

config

status, set, detect_godot, check

서버 구성 및 환경 감지

resources

list, info, delete, import_config

리소스 파일 관리

input_map

list, add_action, remove_action, add_event

입력 액션 및 이벤트 매핑

signals

list, connect, disconnect

신호 연결

animation

create_player, add_animation, add_track, add_keyframe, list

애니메이션 플레이어 및 트랙

tilemap

create_tileset, add_source, set_tile, paint, list

TileMap 및 TileSet 관리

shader

create, read, write, get_params, list

Godot 4 구문을 사용한 셰이더 파일 CRUD

physics

layers, collision_setup, body_config, set_layer_name

충돌 레이어 및 물리 바디

audio

list_buses, add_bus, add_effect, create_stream

오디오 버스 및 효과 관리

navigation

create_region, add_agent, add_obstacle

내비게이션 영역, 에이전트 및 장애물

ui

create_control, set_theme, layout, list_controls

UI 컨트롤 생성 및 테마 설정

help

-

모든 도구에 대한 전체 문서 가져오기

구성

Godot 바이너리는 일반적인 설치 위치와 PATH에서 자동으로 감지됩니다. 기본 사용을 위해 환경 변수는 필요하지 않습니다. 선택적으로 GODOT_PROJECT_PATH 및 GODOT_PATH를 설정하여 기본값을 재정의할 수 있습니다.

변수

필수

기본값

설명

GODOT_PROJECT_PATH

아니요

-

기본 프로젝트 경로 (도구는 project_path 매개변수도 허용)

GODOT_PATH

아니요

자동 감지

Godot 바이너리 경로

제한 사항

  • Godot 4.x 프로젝트 구조가 필요합니다.

  • 씬 파일(.tscn)은 Godot의 내부 API가 아닌 텍스트 조작을 통해 파싱/수정됩니다.

  • run/stop/export 작업을 수행하려면 Godot 바이너리가 설치되어 있어야 합니다.

  • Docker 모드는 파일 시스템 액세스가 제한됩니다 (프로젝트 디렉토리를 마운트하세요).

보안

  • 바이너리 감지 -- 다중 경로 Godot 감지 (환경 변수, PATH, 일반적인 위치)

  • 프로젝트 검증 -- 작업 전 project.godot 존재 여부 확인

  • 크로스 플랫폼 -- Windows, macOS, Linux 경로 처리

소스에서 빌드

git clone https://github.com/n24q02m/better-godot-mcp.git
cd better-godot-mcp
bun install
bun run dev

라이선스

MIT -- LICENSE를 참조하세요.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
B
quality - B tier

How are these scores calculated?

Resources

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/n24q02m/better-godot-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server