Godotゲームエンジンに対するAIアシスタントの完全なコントロールを提供する包括的なModel Context Protocol(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でターゲットをコンパイルします。これは_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).