Godot Engine向け No.1 MCPサーバー

Godotゲーム開発を
AIの力で加速

Godot MCP Proは、ClaudeやCursorなどのAIアシスタントをWebSocket経由でGodot 4エディタに直接接続するMCPサーバーです。163のツールでシーン作成、GDScript記述、プレイヤー入力シミュレーション、実行中のゲーム解析、3D環境構築、物理・パーティクル・オーディオ設定が可能。$5買い切り、Windows・macOS・Linux対応。

itch.ioで入手 Buy Me a Coffee
$5 買い切り · 永久アップデート

実際の動作を見る

プロンプト一つで → AIがリバーシゲームを構築、起動、マウスクリックでプレイテストまで実行。

YouTubeでフルデモを見る → 
AI Assistant <--stdio/MCP--> Node.js Server <--WebSocket--> Godot Editor

リアルタイム双方向通信。ファイルポーリングなし。CLIサブプロセスなし。即座にフィードバック。

ガイド & チュートリアル

AIを活用した実践的なGodot 4ガイド。古いGodot 3の情報は一切なし — すべてGodot 4.4+で検証済みです。

⚡

AIをGodot 4に接続する

5分でMCP Proをセットアップし、ClaudeやCursorからGodotエディタを直接操作。プラグインのインストール、サーバーのビルド、AIクライアントの設定 — これだけで準備完了です。

"プロジェクト情報を取得してシーンツリーを表示して"
初級 ~5 min
使用ツール: get_project_info get_scene_tree
🎮

2Dゲームをゼロから構築

AIに完全な2Dゲームを作ってもらいましょう — シーン、スクリプト、シグナル、UIまで。空のプロジェクトからプレイ可能なリバーシゲームを、たった一回のAI会話で構築する手順を解説します。

"8x8ボードのリバーシゲームを作って。クリックで石を置ける、AI対戦、スコア表示付き"
初級 ~15 min
使用ツール: create_scene add_node create_script connect_signal play_scene
🧑

3Dキャラクターコントローラー

Mixamoアニメーション、AnimationTreeステートマシン、SpringArm3Dカメラ、地形をAIが構築。CharacterBody3D、物理レイヤー、Godot 4のアニメーションブレンドをカバーします。

"地形、x_bot.fbxを使ったキャラクター（歩行/走行/ジャンプアニメ付き）、追従カメラの3Dシーンを作って"
中級 ~20 min
使用ツール: add_mesh_instance setup_lighting create_animation_tree setup_physics_body setup_camera_3d
🔌

Godot 4のシグナルパターン

Godot 4ではシグナルが3から大幅に変更されました。connect("signal", obj, "method")は廃止、signal.connect(callable)を使います。AIにシグナル設計の監査、未接続シグナルの検出、プロジェクト全体のシグナルフロー可視化を任せましょう。

"プロジェクトのシグナルフローを分析して、未接続のシグナルを見つけて"
中級 ~10 min
使用ツール: analyze_signal_flow find_signal_connections get_signals connect_signal
🤖

ゲームの自動テスト

AIにプレイテストを任せましょう。ゲーム起動、キーボード/マウス入力のシミュレーション、スクリーンショット撮影、ゲーム状態の検証、ランダム入力によるストレステスト。テストフレームワーク不要 — MCP Proがエディタレベルで全て処理します。

"ゲームを起動して、右に2秒歩いて、ジャンプして、プレイヤーが足場に到達したか確認して"
中級 ~10 min
使用ツール: play_scene simulate_key capture_frames assert_node_state run_stress_test
🎬

AnimationTreeステートマシン

Godot 4のAnimationTreeは強力ですが複雑です。AIがステートマシンの作成、トランジション設定、ブレンドツリー構築、条件とパラメータの配線を実行。Godot初心者が最もつまずくポイントを数分で解決します。

"Idle、Walk、Run、Jumpステートと適切なトランジションを持つAnimationTreeを作って"
上級 ~15 min
使用ツール: create_animation_tree add_state_machine_state add_state_machine_transition set_tree_parameter
💥

物理演算とコリジョン設定

Godot 4ではPhysicsBodyがCharacterBody/RigidBodyに改名され、コリジョンレイヤーAPIも変更されました。AIにコリジョンシェイプの設定、物理レイヤーの適切な構成、レイキャストの追加、コリジョン設定の監査を任せて、よくある物理バグを回避しましょう。

"全CharacterBody2Dノードのコリジョンを設定して、物理レイヤーを種類別に整理して（player, enemy, environment）"
中級 ~10 min
使用ツール: setup_collision set_physics_layers setup_physics_body get_collision_info
✨

パーティクルエフェクト レシピ集

Godot 4ではCPUParticlesからGPUParticles2D/3Dがデフォルトに。火、煙、雨、雪、火花をプリセットで即座に作成、またはエミッション形状、速度カーブ、カラーグラデーションを自然言語で細かく調整できます。

"松明にオレンジから赤のグラデーションで火のパーティクルを追加して、fireプリセットを適用して"
初級 ~5 min
使用ツール: create_particles apply_particle_preset set_particle_color_gradient set_particle_material

仕組み

5分以内にAIアシスタントをGodotに接続。

プラグインをインストール

addons/godot_mcp/ をGodotプロジェクトにコピー。プロジェクト > プロジェクト設定 > プラグインで有効化。エディタ内でWebSocketサーバーが自動起動します。

MCPサーバーをビルド

server/ ディレクトリで npm install && npm run build を実行。AIクライアントとGodotプラグインを橋渡しするTypeScript MCPサーバーをコンパイルします。

AIで開発スタート

AIクライアントのMCP設定にサーバーを追加。Godotを開けば、AIアシスタントが163のツールにリアルタイムアクセス — シーン作成、スクリプト編集、入力シミュレーション、実行中のゲーム解析が可能に。

163
ツール
23
カテゴリ
16
独自カテゴリ
（競合にない機能）
∞
Undo/Redo
全変更に対応

163ツール、23カテゴリ

AIにGodotプロジェクトの構築・検査・テスト・修正を任せるために必要なすべて。2Dも3Dも対応。

Project

7 tools
  • get_project_info metadata & autoloads
  • get_filesystem_tree recursive file tree
  • search_files fuzzy/glob search
  • get/set_project_settings read & write
  • uid_to_project_path UID conversion
  • project_path_to_uid path conversion

Scene

9 tools
  • get_scene_tree live hierarchy
  • get_scene_file_content raw .tscn
  • create_scene new scenes
  • open_scene delete_scene save_scene
  • add_scene_instance prefab-like instancing
  • play_scene stop_scene

Node

11 tools
  • add_node delete_node rename_node
  • duplicate_node deep copy
  • move_node reparent
  • update_property smart type parsing
  • get_node_properties inspect all props
  • add_resource shapes, materials
  • set_anchor_preset UI anchors
  • connect_signal disconnect_signal

Script

6 tools
  • list_scripts project-wide overview
  • read_script create_script
  • edit_script search/replace & insert
  • attach_script attach to nodes
  • get_open_scripts editor awareness

Editor

9 tools
  • get_editor_errors errors & stack traces
  • get_editor_screenshot editor viewport
  • get_game_screenshot running game
  • compare_screenshots visual diff NEW
  • execute_editor_script run GDScript
  • get_signals inspect signal connections
  • reload_plugin reload_project
  • clear_output

Input Simulation

5 tools
  • simulate_key keyboard with modifiers
  • simulate_mouse_click positioned clicks
  • simulate_mouse_move absolute/relative
  • simulate_action Godot InputActions
  • simulate_sequence multi-event combos

Runtime Analysis

15 tools
  • get_game_scene_tree live game hierarchy
  • get/set_game_node_properties runtime inspection & tweaking
  • execute_game_script run code in live game
  • capture_frames multi-frame screenshots
  • monitor_properties property timeline
  • start/stop/replay_recording input recording & replay NEW
  • find_nodes_by_script get_autoload
  • find_ui_elements click_button_by_text NEW
  • wait_for_node batch_get_properties NEW

Animation

6 tools
  • list_animations create_animation
  • add_animation_track value/position/bezier
  • set_animation_keyframe insert keys
  • get_animation_info tracks & keyframes
  • remove_animation

AnimationTree NEW

8 tools
  • create_animation_tree with state machine root
  • get_animation_tree_structure full tree inspection
  • add/remove_state_machine_state manage states
  • add/remove_state_machine_transition with conditions
  • set_blend_tree_node Add2, Blend2, TimeScale
  • set_tree_parameter conditions & blends

TileMap

6 tools
  • tilemap_set_cell place tiles
  • tilemap_fill_rect fill regions
  • tilemap_get_cell read tile data
  • tilemap_clear clear all
  • tilemap_get_info tile set sources
  • tilemap_get_used_cells query used cells

3D Scene NEW

6 tools
  • add_mesh_instance primitives & .glb/.gltf import
  • setup_lighting sun/indoor/dramatic presets
  • set_material_3d full PBR material setup
  • setup_environment sky, fog, glow, SSAO, SSR
  • setup_camera_3d projection, FOV, cull mask
  • add_gridmap GridMap with MeshLibrary

Physics NEW

6 tools
  • setup_collision auto-detect 2D/3D shapes
  • set/get_physics_layers layer & mask management
  • add_raycast RayCast2D/3D
  • setup_physics_body CharacterBody & RigidBody config
  • get_collision_info full collision audit

Particles NEW

5 tools
  • create_particles GPUParticles 2D/3D
  • set_particle_material direction, velocity, emission shape
  • set_particle_color_gradient color ramp stops
  • apply_particle_preset fire, smoke, rain, snow, sparks
  • get_particle_info full config inspection

Navigation NEW

5 tools
  • setup_navigation_region auto-detect 2D/3D
  • bake_navigation_mesh mesh baking & polygon gen
  • setup_navigation_agent pathfinding & avoidance
  • set_navigation_layers layer management
  • get_navigation_info full nav audit

Audio NEW

6 tools
  • get_audio_bus_layout full bus overview
  • add_audio_bus set_audio_bus create & configure
  • add_audio_bus_effect reverb, delay, compressor, EQ
  • add_audio_player 2D/3D audio players
  • get_audio_info subtree audio audit

Theme & UI

6 tools
  • create_theme new Theme resource
  • set_theme_color color overrides
  • set_theme_constant constant overrides
  • set_theme_font_size font sizes
  • set_theme_stylebox StyleBoxFlat
  • get_theme_info inspect overrides

Shader

6 tools
  • create_shader with templates
  • read_shader edit_shader
  • assign_shader_material to nodes
  • set_shader_param set uniforms
  • get_shader_params read all params

Resource NEW

3 tools
  • read_resource inspect .tres properties
  • edit_resource modify & save
  • create_resource new .tres of any type

Batch & Refactoring

6 tools
  • find_nodes_by_type search by class
  • find_signal_connections audit signals
  • batch_set_property bulk changes
  • find_node_references cross-file search
  • get_scene_dependencies dependency graph
  • cross_scene_set_property project-wide changes NEW

Testing & QA NEW

5 tools
  • run_test_scenario automated test sequences
  • assert_node_state property assertions
  • assert_screen_text UI text verification
  • run_stress_test random input fuzzing
  • get_test_report pass/fail summary

Code Analysis NEW

6 tools
  • find_unused_resources dead asset detection
  • analyze_signal_flow signal graph mapping
  • analyze_scene_complexity node count & depth
  • find_script_references cross-project search
  • detect_circular_dependencies cycle detection
  • get_project_statistics full project overview

Profiling

2 tools
  • get_performance_monitors FPS, memory, physics
  • get_editor_performance quick summary

Export

3 tools
  • list_export_presets configured presets
  • export_project build commands
  • get_export_info paths & templates

なぜProなのか？

無料版にはない機能。

シグナル管理

ノード間のシグナルを接続・切断・検査。競合にはない機能。Godotのイベント駆動アーキテクチャに不可欠です。

完全なUndo/Redo

すべての変更がGodotのUndoRedoシステムを経由。AIの操作もCtrl+Zで元に戻せます。無料版はシーンを直接変更するためUndoが効きません。

スマート型変換

Vector2(100,200)、#ff0000、Color(1,0,0) — AIが文字列を送ると、適切なGodot型に自動変換します。

本番品質の接続

ハートビート付きWebSocket、自動再接続（指数バックオフ）、ポート自動スキャン。接続切れなし、手動再起動不要。

文脈に応じたエラー提案

エラーには構造化コードと対処法が含まれます。AIが不明なエラーで停止せず、自己修正できます。

完全なノード操作

11のノードツール：追加、削除、リネーム、複製、移動/再配置、プロパティ更新、リソース追加、アンカー設定。すべてをカバーする競合はありません。

入力シミュレーション & 録画

AIにゲームをプレイさせましょう。キーボード、マウス、InputActionをシミュレート。入力セッションを録画し、フレーム精度でリプレイしてリグレッションテスト。

ランタイム解析

実行中のゲームを検査する15のツール。ランタイムでプロパティの読み書き、フレームキャプチャ、プロパティ変更の監視、UI要素の検索、テキストボタンのクリック、ノード出現の待機。

アニメーション & AnimationTree

アニメーション作成、トラック追加、キーフレーム挿入。トランジションと条件付きステートマシンの構築。Add2、Blend2、TimeScaleノードでブレンドツリーを構成。

3Dシーン構築

メッシュ追加（プリミティブまたは.glb/.gltf）、プリセットでライティング設定、PBRマテリアル構成、sky/fog/SSAO/SSRで環境作成、カメラ配置、GridMap構築。

物理演算 & ナビゲーション

コリジョンシェイプの設定、物理ボディの構成、コリジョンレイヤー管理、レイキャスト追加。ナビゲーション領域の作成、ナビメッシュのベイク、パスファインディングエージェントの設定。

パーティクル & オーディオ

プリセット（火、煙、雨、雪）でGPUパーティクルシステムを作成。オーディオバス管理、エフェクト追加（リバーブ、ディレイ、コンプレッサー）、2D/3Dオーディオプレイヤーの配置。

シェーダーパイプライン

テンプレートからシェーダー作成、GLSLコード編集、ShaderMaterial割り当て、ランタイムでuniform調整。AIチャットを離れることなく完全なシェーダーワークフロー。

テスト & QA

入力シミュレーションとアサーションで自動テストシナリオを実行。画面上のUIテキストを検証。ランダム入力ファジングでストレステスト。合否テストレポートを生成。

コード解析

未使用リソースの検出、シグナルフローのマッピング、シーン複雑度の分析、循環依存の検出、スクリプト参照の検索、プロジェクト全体の統計取得。

バッチ操作

型でノード検索、シグナル接続の監査、シーン横断でプロパティ一括設定、全プロジェクトファイルの横断検索、依存関係分析。大規模リファクタリング。

AIはGodotプロジェクトで何ができる？

AIアシスタントに頼める実例 — そのまま動きます。

ゲームをゼロから構築

"8x8グリッドのリバーシを作って。クリックで石を置く、AI対戦、スコア表示付き"

AIがシーン作成、スクリプト記述、シグナル接続、UI構築、ゲーム実行まで — 一回の会話で完結。デモ動画をご覧ください。

使用: create_scene add_node create_script connect_signal play_scene

3D環境を構築

"地形メッシュを追加して、影付きのドラマチックなライティング、ラフネス0.3のPBRマテリアル、密度0.02のボリュメトリックフォグを設定して"

AIがメッシュ追加、ライティングプリセット設定、PBRマテリアル構成、環境設定の調整まで — すべてエディタAPI経由でUndo/Redo付き。

使用: add_mesh_instance setup_lighting set_material_3d setup_environment

自動プレイテスト

"ゲームを起動して、キャラクターを右に2秒歩かせて、ジャンプして、足場に到達したか確認して"

AIがゲーム起動、キーボード入力シミュレーション、スクリーンショット撮影、ランタイムノードプロパティ検査、ゲーム状態検証まで — 自動QAワークフローを実現。

使用: play_scene simulate_key get_game_screenshot get_game_node_properties assert_node_state

GDScriptエラーをデバッグ

"エディタのエラーを確認して修正して"

AIがエディタのエラー出力とスクリプトコンパイルエラーを読み取り、問題を特定、スクリプトを修正、修正を検証 — エラーメッセージのコピペ不要の高速フィードバックループ。

使用: get_editor_errors read_script edit_script get_editor_errors

パーティクルエフェクトを追加

"松明ノードにオレンジから赤のグラデーションで上向きの火パーティクルを追加して"

AIがGPUパーティクルを作成、エミッション形状と速度を設定、カラーグラデーションを適用。または内蔵プリセット（火、煙、雨、雪、火花）で即座に結果を表示。

使用: create_particles set_particle_material set_particle_color_gradient

シーン横断リファクタリング

"プロジェクト内の全CharacterBody2Dノードを見つけてfloor_snap_lengthを8に設定して"

AIが全シーンを横断検索、該当ノードを特定、プロパティを一括変更 — 手動クリックで数分かかる作業が数秒で完了。

使用: find_nodes_by_type batch_set_property cross_scene_set_property

比較

Godot MCP Proと他ツールとの比較。

機能 Godot MCP Pro GDAI MCP ($19) godot-mcp (free)
ツール数163~3013
カテゴリ23~84
接続方式WebSocket + heartbeatWebSocketHeadless CLI
Undo/RedoYesYesNo
シグナル管理YesNoNo
ノード名変更/複製/移動YesNoNo
スマート型変換YesLimitedNo
入力シミュレーションKey / Mouse / Action / SequenceNoNo
ランタイム解析15ツール（ツリー、プロパティ、フレーム、UI、録画）NoNo
3DシーンツールMesh, Lighting, PBR, Environment, CameraNoNo
物理設定Collision, Layers, Raycasts, BodiesNoNo
パーティクルGPU 2D/3D with presetsNoNo
ナビゲーションRegion, Mesh baking, AgentNoNo
オーディオBuses, Effects, PlayersNoNo
AnimationTreeState machine, Blend treeNoNo
自動テストシナリオ、アサーション、ストレステストNoNo
コード解析未使用リソース、シグナルフロー、複雑度NoNo
スクリーンショットエディタ + ゲーム + 画像差分YesNo

よくある質問

Godot MCP Proについてよくある質問。

Godot MCP Proとは？

Godot MCP Proは、Claude、Cursor、ClineなどのAIアシスタントをWebSocket経由でGodot 4エディタに直接接続するプレミアムMCP（Model Context Protocol）サーバーです。シーン操作、アニメーション、3Dモデリング、物理設定、パーティクル、オーディオ管理、シェーダー編集、入力シミュレーション、ランタイム解析、自動テストなど23カテゴリ163ツールを提供します。

ClaudeをGodotに接続するには？

プロジェクトにGodot MCP Proプラグインをインストール、プロジェクト設定 > プラグインで有効化、npm install && npm run buildでMCPサーバーをビルド、.mcp.jsonに追加。Claude（CodeまたはDesktop）がWebSocket経由でGodotエディタに自動接続し、163のツールすべてにアクセスできます。

どのAIアシスタントが対応していますか？

Claude Code、Claude Desktop、Cursor、VS Code + Cline拡張、Windsurf等、MCP互換のAIクライアントすべてに対応。MCPプロトコルはオープン標準のため、新しいクライアントも随時追加されます。

AIはGodotで3Dゲームを作れますか？

はい。メッシュプリミティブの追加や.glb/.gltfモデルのインポート、プリセットでのライティング設定、PBRマテリアル構成、sky/fog/SSAO/SSRの環境作成、カメラ配置、GridMap構築のための専用3Dツールを搭載。物理、ナビゲーション、パーティクルツールと組み合わせて、AIが完全な3Dゲームシーンを構築できます。

AIにゲームのプレイテストを任せられますか？

はい。ランタイム解析スイートの15ツールで、AIがゲーム起動、キーボード/マウス/アクション入力のシミュレーション、スクリーンショット撮影、実行中のシーンツリー検査、ランタイムプロパティの読み書き、入力セッションの録画・リプレイ、UI要素の検索、テキストボタンのクリック、アサーション付き自動テストシナリオの実行が可能です。

Cursorで動作しますか？

はい。Cursor、VS Code + Cline、Windsurf、Claude Code CLI、Claude Desktop等、MCP互換クライアントすべてで動作します。エディタの設定でMCPサーバーを設定すればWebSocket経由で接続されます。

必要なGodotのバージョンは？

Godot 4.4以降（Godot 4.6でテスト済み）およびNode.js 18+。Windows、macOS、Linuxに対応。

無料の代替ツールとの違いは？

Godot MCP Proは163ツール（無料版は13〜32）を提供。独自機能として完全なUndo/Redo、シグナル管理、録画・リプレイ付き入力シミュレーション、15ツールのランタイム解析、3Dシーン構築、物理設定、パーティクルシステム、オーディオバス管理、ナビゲーションメッシュ、AnimationTreeステートマシン、自動テスト、コード解析を備えています。

プラグインのソースコードは公開されていますか？

はい。GDScriptエディタプラグイン（addons/godot_mcp/）は完全オープンソースでGitHubで公開されています。購入前にプラグインの通信方法を確認できます。MCPサーバー（TypeScript）は有料ダウンロードに含まれています。

サブスクリプションはありますか？

いいえ。Godot MCP Proは$5の買い切りで、v1.xの永久アップデート、プロジェクト数無制限、マシン数無制限、Discordサポート付き。月額料金なし、ライセンス制限なし。

クイックセットアップガイド

5分以内にセットアップ完了。

1. Godotプラグインをインストール

ダウンロードした addons/godot_mcp/ フォルダをGodotプロジェクトのルートにコピー。プラグインを有効化：

Project > Project Settings > Plugins > Godot MCP Pro > Enable

2. MCPサーバーをビルド

server/ ディレクトリでターミナルを開き：

cd server
npm install
npm run build

3. AIクライアントを設定

AIクライアントのMCP設定ファイル（Claude Codeなら .mcp.json）にサーバーを追加：

{
  "mcpServers": {
    "godot-mcp-pro": {
      "command": "node",
      "args": ["/path/to/server/build/index.js"]
    }
  }
}

4. 使い始める

プラグインを有効にしたGodotプロジェクトを開きます。エディタドックのステータスパネルで接続状態を確認。AIアシスタントを起動して開発開始 — Godotエディタの163ツールに直接アクセスできます。

シンプルな買い切り価格

一度の支払いで永久に使用。v1.xの永久アップデート付き。

$5
買い切り
  • ✓ 23カテゴリ163ツールすべて
  • ✓ 2D・3D対応
  • ✓ 永久アップデート（v1.x）
  • ✓ プロジェクト数無制限
  • ✓ マシン数無制限
  • ✓ Discordサポートチャンネル
itch.ioで購入 Buy Me a Coffee 質問は Discord へ