Skip to main content
Glama
n24q02m

Better Godot MCP

by n24q02m

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: Better Notion MCP

설정

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_PATHGODOT_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
license - permissive license
A
quality
A
maintenance

Maintenance

Maintainers
1dResponse time
2dRelease cycle
93Releases (12mo)
Commit activity
Issues opened vs closed

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Discover AI tools for game development — 100+ tools indexed by engine, task, and pricing.

  • Deterministic AI agent microtools, no accounts/API keys. fetch_extract: 98% token cut. 38 tools.

  • Generate game assets with AI: sprites, 3D models, animations, sound effects, music, and voices.

View all MCP Connectors

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