Skip to main content
Glama
Better Godot MCP

Better Godot MCP

by n24q02m

Better Godot MCP

mcp-name: io.github.n24q02m/better-godot-mcp

Godot Engine用複合MCPサーバー -- AI支援によるゲーム開発のための17のメガツール

CI codecov npm Docker License: MIT

TypeScript Node.js Godot Engine semantic-release Renovate

特徴

  • 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 に従ってください

ツール

ツール

アクション

説明

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_PATH と GODOT_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 を参照してください。

Available Tools

17 tools
animationC

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

configA
Idempotent

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

editorA
Idempotent

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

helpA
Read-onlyIdempotent

Full documentation. Omit topic for the overview; use a topic when compressed descriptions are insufficient.

Inputs: topic.

input_mapA
Destructive

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

nodesA
Destructive

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

resourcesB
Destructive

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

scenesA
Destructive

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

scriptsA
Destructive

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

signalsA
Destructive

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

    B3.4/5.0

    Scored across 17 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers