一个全面的模型上下文协议（MCP）服务器，赋予AI助手对Godot游戏引擎的完全控制。157个工具涵盖网络、3D/2D渲染、UI控制、音频特效、动画树、文件I/O、运行时代码执行、属性检查、场景操作、信号管理、物理、项目创建等。

致谢

该项目基于并扩展了 Solomon Elias（Coding-Solo）的 Godot-mcp。原始项目提供了基础架构，包括 TypeScript MCP 服务器、无头 GDScript 运算系统和基于 TCP 的运行时交互服务器。感谢您通过出色的开源工作使这一切成为可能！

有什么新内容（比原版改进）

最初的 Godot-mcp 提供了 20 个用于基础项目管理和场景创建的工具。该分支扩展至 157 个工具，并新增了以下主要内容：

3.1 新增内容

• validate_script 自动加载解析 - 脚本验证现在通过 SceneTree 在项目自动加载注册后，编译目标，而不是在 _init() 处编译。

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).