Godot Mcp Server

Godot MCP Server

AI アシスタントに Godot エディターへの完全なアクセス権を与えましょう。

Claude、Cursor、または MCP 対応の AI を使って、ゲームをより速く開発できます。コピー＆ペーストやコンテキストの切り替えは不要です。AI は、実行中の Godot エディター内でシーン、スクリプト、ノード、プロジェクト設定を直接読み取り、書き込み、操作します。

Godot 4.4+ · 69 個のツール · 元に戻す／やり直す · インタラクティブなプロジェクトビジュアライザー · MIT ライセンス

---

クイックスタート

0. Node.js をインストールする（初回のみ）

nodejs.org からインストーラー（LTS バージョン）をダウンロードして実行します。一般的なインストーラーなので、ターミナルは必要ありません。

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

クローンやビルドは不要です。npx から直接実行できます。

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json を編集します。

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "godot-mcp-server"]
    }
  }
}

Cursor — MCP 設定（Settings → MCP → Add Server）に追加します。

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "godot-mcp-server"]
    }
  }
}

MCP 対応のクライアント（Claude Code、Cline、Windsurf など）であれば、どれでも動作します。

2. Godot プラグインをインストールする

GitHub リポジトリから addons/godot_mcp/ フォルダーを Godot プロジェクトの addons/ ディレクトリにコピーします。次に、Project → Project Settings → Plugins → Godot MCP → Enable で有効にします。

または、Godot エディター内からインストールします。Asset Store タブ（Godot 4.7 以降。「Godlink MCP」を検索）または AssetLib タブ（Godot 4.6 以前。「mcp」を検索）→ Install。

3. 接続する

Godot プロジェクトを再起動します。エディターの右上隅に、緑色で MCP: Agent Active と表示されていることを確認します。これで準備完了です。

---

何ができますか？

6 カテゴリにわたる 32 個のツール

カテゴリ	ツール数	例
ファイル操作	4	ディレクトリの参照、ファイルの読み取り、プロジェクトの検索、スクリプトの作成
シーン操作	11	シーンの作成、ノードの追加／削除／移動、プロパティの設定、スクリプトのアタッチ、コリジョンシェイプとテクスチャの割り当て
スクリプト操作	6	コード編集の適用、構文の検証、参照の更新を伴うファイル名変更／移動
プロジェクトツール	9	プロジェクト設定、入力マップ、コリジョンレイヤー、コンソールエラー、シーンツリーのダンプの読み取り
アセット生成	1	SVG から 2D スプライトを生成
可視化	1	ブラウザー上で操作できるプロジェクトマップ

インタラクティブビジュアライザー

map_project を実行すると、localhost:6510 にブラウザー上のプロジェクトエクスプローラーが表示されます。

• すべてのスクリプトとその関連性を示す力学ベースのグラフ
• スクリプトをクリックすると、変数、関数、シグナル、接続を表示
• ビジュアライザー上で直接コードを編集可能。変更はリアルタイムで Godot に同期
• ノードプロパティを編集できるシーンビュー
• リファクタリング前に使用箇所を検索

---

仕組み

┌─────────────┐    MCP (stdio)    ┌─────────────┐   WebSocket    ┌──────────────┐
│  AI Client   │◄────────────────►│  MCP Server  │◄─────────────►│ Godot Editor │
│  (Claude,    │                  │  (Node.js)   │   port 6505   │  (Plugin)    │
│   Cursor)    │                  │              │               │              │
└─────────────┘                  │  Visualizer  │               │  32 tool     │
                                 │  HTTP :6510  │               │  handlers    │
                                 └──────┬───────┘               └──────────────┘
                                        │
                                 ┌──────▼───────┐
                                 │   Browser     │
                                 │  Visualizer   │
                                 └──────────────┘

MCP サーバーは Godot プラグインを介して WebSocket で Godot エディターに接続します。AI がプロジェクト構造を推測することはありません。実行中のエディターからライブ状態を直接読み取ります。

---

現在の制限事項

• ローカルのみ — localhost 上で動作し、リモート接続には対応していません
• 同時に使用できる Godot エディターは 1 つ — 複数の AI クライアントが同時に接続できますが、すべて同じ Godot インスタンスを共有します
• Ctrl+Z では AI による変更を元に戻せません — プラグインはエディターのライブツリーではなくディスクに書き込むため、Godot 標準の元に戻す機能では変更を取り消せません。代わりに mcp_undo ツールを使用してください（エージェントに元に戻すよう依頼します）。
• AI の Godot に関する知識には限りがあります — デバッグ、スクリプト作成、シーン構築を支援できますが、ガイダンスなしでゲーム全体を作成することはできません

---

ソースからビルドする

git clone https://github.com/tomyud1/godot-mcp
cd godot-mcp/mcp-server
npm install
npm run build

その後、npx を使う代わりに、AI クライアントが mcp-server/dist/index.js を参照するように設定します。

---

ライセンス

MIT

---

GitHub · 問題を報告