Better Godot MCP
Better Godot MCP
mcp-name: io.github.n24q02m/better-godot-mcp
Godot Engine用複合MCPサーバー -- AI支援によるゲーム開発のための17のメガツール
特徴
17の複合メガツール -- シーン、ノード、スクリプト、シェーダー、アニメーション、タイルマップ、物理演算、オーディオ、ナビゲーション、UIなど
完全なシーン制御 -- Godotを起動せずに
.tscnファイルを直接作成、解析、変更可能GDScript CRUD -- 1回の呼び出しでスクリプトの作成、読み取り、書き込み、アタッチが可能
階層化されたトークン最適化 -- 圧縮された説明文 + オンデマンドの
helpツール
Related MCP server: Godot MCP Unified
セットアップ
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 に従ってください
ツール
ツール | アクション | 説明 |
|
| プロジェクトのメタデータ、実行/停止、設定 |
|
| シーンファイルの管理 |
|
| シーンツリーのノード操作 |
|
| GDScriptファイルのCRUD |
|
| Godotエディタの起動とステータス確認 |
|
| サーバー設定と環境検出 |
|
| リソースファイルの管理 |
|
| 入力アクションとイベントのマッピング |
|
| シグナルの接続 |
|
| アニメーションプレイヤーとトラック |
|
| TileMapとTileSetの管理 |
|
| Godot 4構文によるシェーダーファイルのCRUD |
|
| コリジョンレイヤーと物理ボディ |
|
| オーディオバスとエフェクトの管理 |
|
| ナビゲーションリージョン、エージェント、障害物 |
|
| UIコントロールの作成とテーマ設定 |
| - | 任意のツールの完全なドキュメントを取得 |
設定
Godotバイナリは一般的なインストール場所と PATH から自動検出されます。基本的な使用には環境変数は不要です。必要に応じて GODOT_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 を参照してください。
Available Tools
17 toolsanimationC
Animation management. Actions: create_player|add_animation|add_track|add_keyframe|list. Use help tool for full docs.
Inputs: action (required), loop, name, parent, +7 more. Returns: object
audioC
Audio bus and stream management. Actions: list_buses|add_bus|add_effect|create_stream. Use help tool for full docs.
Inputs: action (required), bus, name, parent, +6 more. Returns: object
configAIdempotent
Server configuration and environment.
Actions (required params -> optional):
status: current config
set (key, value): update setting
detect_godot: find Godot binary path
check: verify project and Godot availability
Inputs: action (required), key, value. Returns: object
editorAIdempotent
Godot editor control.
Actions (required params -> optional):
launch (-> project_path): open editor
status (-> project_path): check if editor is running
For running the game, use project(action="run") instead.
Inputs: action (required), project_path. Returns: object
helpARead-onlyIdempotent
Full documentation. Omit topic for the overview; use a topic when compressed descriptions are insufficient.
Inputs: topic.
input_mapADestructive
Input action management.
Actions (required params -> optional):
list (-> project_path): all input actions
add_action (action_name -> deadzone=0.5, project_path)
remove_action (action_name -> project_path)
add_event (action_name, event_type, event_value -> project_path)
event_type: key | mouse | joypad. event_value: e.g., KEY_SPACE.
Inputs: action (required), deadzone, event_type, action_name, +2 more. Returns: object
nodesADestructive
Scene node operations.
Actions (required params -> optional):
add (scene_path, name -> type="Node", parent=".", project_path)
remove (scene_path, name -> project_path)
rename (scene_path, name, new_name -> project_path)
list (scene_path -> project_path)
set_property (scene_path, name, property, value -> project_path)
get_property (scene_path, name, property -> project_path)
Node paths: relative to scene root using "/" (e.g., "Player/Sprite2D"). Use "." for root.
Inputs: action (required), name, type, value, +5 more. Returns: object
physicsC
Physics config. Actions: layers|collision_setup|body_config|set_layer_name. Use help tool for full docs.
Inputs: action (required), mass, name, dimension, +6 more. Returns: object
projectA
Godot project operations.
Actions (required params -> optional):
info (-> project_path): project metadata
version: Godot engine version
run (-> scene_path, project_path): launch game
logs (-> pid): last captured stdout/stderr lines from a run (default: most recently started)
stop: stop running game
settings_get (key -> project_path): read project setting
settings_set (key, value -> project_path): write project setting
export (preset, output_path -> project_path): export game build
Inputs: action (required), key, pid, value, +4 more. Returns: object
resourcesBDestructive
Resource file management.
Actions (required params -> optional):
list (-> type, project_path): browse resources (type: image|audio|font|shader|scene|resource)
info (resource_path -> project_path): resource metadata
delete (resource_path -> project_path)
import_config (resource_path -> project_path): view import settings
Inputs: action (required), type, project_path, resource_path. Returns: object
scenesADestructive
Scene file (.tscn) CRUD.
Actions (required params -> optional):
create (scene_path -> root_type="Node2D", root_name, project_path)
list (-> project_path)
info (scene_path -> project_path)
delete (scene_path -> project_path)
duplicate (scene_path, new_path -> project_path)
set_main (scene_path -> project_path)
scene_path: relative to project root (e.g., "scenes/main.tscn"), NOT res:// prefix. Use nodes tool to edit nodes within a scene.
Inputs: action (required), new_path, root_name, root_type, +2 more. Returns: object
scriptsADestructive
GDScript file CRUD.
Actions (required params -> optional):
create (script_path -> extends="Node", content, project_path): generate template
read (script_path -> project_path)
write (script_path, content -> project_path): replace entire file
attach (script_path, scene_path, node_name -> project_path): link to scene node
list (-> project_path)
delete (script_path -> project_path)
script_path: relative to project root (e.g., "scripts/player.gd").
Inputs: action (required), content, extends, node_name, +3 more. Returns: object
shaderC
Godot shader management. Actions: create|read|write|get_params|list. Use help tool for full docs.
Inputs: action (required), content, shader_path, shader_type, +1 more. Returns: object
signalsADestructive
Signal connection management.
Actions (required params -> optional):
list (scene_path -> project_path): all signal connections
connect (scene_path, signal, from, to, method -> flags, project_path)
disconnect (scene_path, signal, from, to, method -> project_path)
Inputs: action (required), to, from, flags, +4 more. Returns: object
tilemapC
TileSet and TileMap management. Actions: create_tileset|add_source|set_tile|paint|list. Use help tool for full docs.
Inputs: action (required), tile_size, scene_path, project_path, +2 more. Returns: object
uiC
UI Control nodes and themes. Actions: create_control|set_theme|layout|list_controls. Use help tool for full docs.
Inputs: action (required), name, type, parent, +5 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 17 tools
Each tool targets a distinct Godot subsystem, and explicit notes (e.g., editor launch vs project run) reduce confusion. Some overlap remains between project settings and config, and between scenes and generic resource management.
Tool names follow a consistent single-noun domain pattern with verb-style actions underneath. Minor inconsistencies like plural scenes/nodes/scripts vs singular animation/shader and the underscore in input_map prevent a perfect score.
At roughly 16-17 tools, the server sits at the upper edge of the ideal range, but each tool covers a separate Godot domain and earns its place. It is slightly heavy but not bloated.
The surface covers the core Godot development lifecycle: project, editor, scenes, scripts, resources, input, signals, rendering, physics, audio, navigation, and UI. Minor gaps exist, such as no generic resource creation and abbreviated documentation for several advanced domains.
Maintenance
Related MCP Connectors
Generate, search and export game-ready sprite sheets for Godot, Unity and other game engines.
Search, generate, refine, and export pixel art VFX for games, including sprite sheets and Godot 4.
Gamedev tools for AI agents: level design, renders, sprites, GLB optimizer. Pay per call with x402.
Make all the audio for your game from a single prompt. Describe your game and your AI assistant plans every sound it needs (sound effects, ambience loops, music tracks and character voice lines), then generates them all in one go. You get several AI versions of each sound and keep the ones you like. Sounds are organized per game in folders and scenes, and the free Godot plugin installs them into your project, ready to play with one line of code. Works with Claude, Claude Code, Cursor and any MCP client, with OAuth login (no API key needed). Free plan included; sounds can be used in commercial games.
Related MCP Servers
- AlicenseAqualityAmaintenanceMarkdown-first MCP server for Notion that provides 7 composite action-based tools consolidating 28+ REST API endpoints, enabling AI agents to efficiently manage pages, databases, blocks, and content with automatic pagination and bulk operations.101,730 npm36Apache 2.0
- AlicenseNot gradedqualityFmaintenanceEnables complete natural language control of Godot Engine 4.5+ with 76 tools for managing scripts, scenes, nodes, animations, physics, tilemaps, audio, shaders, navigation, particles, UI, lighting, assets, and exports. Integrates with Claude Desktop, VS Code, and Ollama for AI-assisted game development.2MIT
- AlicenseAqualityAmaintenanceWeb search (embedded SearXNG), content extraction, and library docs indexing with hybrid search. No API keys required.6733 PyPI24Apache 2.0
- AlicenseAqualityAmaintenancePersistent AI memory with SQLite hybrid search (FTS5 + semantic), built-in Qwen3 embedding, and rclone sync across machines.15585 PyPI13Apache 2.0