Godot 게임 엔진에 대한 AI 비서에게 완전한 제어를 제공하는 포괄적인 모델 컨텍스트 프로토콜(MCP) 서버입니다. 157개의 도구가 네트워킹, 3D/2D 렌더링, UI 제어, 오디오 효과, 애니메이션 트리, 파일 I/O, 런타임 코드 실행, 속성 검사, 장면 조작, 신호 관리, 물리 물리, 프로젝트 생성 등 다양한 기능을 포함합니다.

감사의 말

이 프로젝트는 Solomon Elias(코딩-솔로)의 godot-mcp를 기반으로 구축되고 확장되었습니다. 원래 프로젝트는 TypeScript MCP 서버, 헤드리스 GDScript 운영 시스템, TCP 기반 런타임 상호작용 서버 등 기본 아키텍처를 제공했습니다. 훌륭한 오픈소스 작업 덕분에 이 모든 것이 가능해졌습니다!

새로운 점들 (원래보다 개선됨)

원래 Godot-mcp는 기본 프로젝트 관리와 씬 생성을 위한 20개의 도구를 제공했습니다. 이 포크는 다음과 같은 주요 추가 기능을 포함하여 157개의 도구로 확장합니다:

3.1 신규

• validate_script 자동 로드 해결 - 스크립트 검증은 이제 SceneTree를 통해 SceneTree(프로젝트 자동 로드 등록 후)에서 SceneTree를 통해 컴파일하며, _init()에서 --check-only로 컴파일됩니다.

Godot MCP - Full Control

A comprehensive Model Context Protocol (MCP) server that gives AI assistants full control over the Godot game engine. 157 tools spanning networking, 3D/2D rendering, UI controls, audio effects, animation trees, file I/O, runtime code execution, property inspection, scene manipulation, signal management, physics, project creation, and more.

Acknowledgments

This project is built upon and extends godot-mcp by Solomon Elias (Coding-Solo). The original project provided the foundational architecture including the TypeScript MCP server, headless GDScript operations system, and TCP-based runtime interaction server. Thank you for making this possible with your excellent open-source work!

What’s New (Improvements Over Original)

The original godot-mcp provided 20 tools for basic project management and scene creation. This fork extends it to 157 tools with the following major additions:

New in 3.1

• validate_script autoload resolution - Script validation now compiles the target through a SceneTree at _initialize() (after project autoloads are registered) instead of --check-only at _init(). References to autoload singletons no longer produce false Identifier not found errors, while real syntax/type errors are still caught. Verified building a full game whose scripts reference several autoloads.
• manage_input_map event merging - Adding a second key to an existing input action now merges it into that action’s events array (with physical_keycode de-duplication) instead of writing a duplicate actionname= line, which previously left project.godot malformed and silently dropped earlier bindings.

New in 3.0

• .NET / C# support - Scaffold C# projects and generate C# scripts (create_project with dotnet: true, create_csharp_script); the .csproj SDK version is matched to your installed Godot.
• GDScript diagnostics - Validate scripts for syntax and type errors without running the game (validate_script, and validate_scripts for all git-changed or project-wide files).