godot-mcp-bridge

godot-mcp-bridge

AI アシスタントに Godot エディターへの完全なアクセスを提供します。

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

Godot 4.5+ · 225 個のツール（デフォルトで 35 個を読み込み） · ライブツリー編集と取り消し · インタラクティブなプロジェクトビジュアライザー · MIT ライセンス

ツールの詳細な内訳、アーキテクチャ、セットアップガイドについては、プロジェクトの READMEをご覧ください。このファイルは npm に表示される要約版です。

---

クイックスタート

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

npx godot-mcp-bridge install

Godot プロジェクトフォルダー内から実行すると、アドオンが addons/godot_mcp/ にコピーされ、プラグインが有効になります。または、GitHub リポジトリから addons/godot_mcp/ を手動でコピーし、プロジェクト設定 → プラグインで有効にしてください。（「Godot AI Assistant tools MCP」の AssetLib 掲載ページは、このフォーク元のプロジェクトのものであり、このリポジトリのものではありません。）

2. AI クライアントにサーバーを追加する

Claude Desktop / Cursor — クライアントの MCP 設定に追加します：

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

Windows の場合は、"command": "cmd", "args": ["/c", "npx", "-y", "godot-mcp-bridge"] を使用してください。

MCP 互換のクライアント（Claude Code、Cline、Windsurf など）であれば使用できます。

3. 接続する

AI クライアントを再起動してから、Godot プロジェクトを再起動します。エディターの右上隅に、緑色の MCP Connected が表示されていることを確認してください。

---

何ができますか？

目的別に分類された 225 個のツールがあります。エージェントが作業に集中できるよう、デフォルトでは core（35 個のツール）のみが読み込まれます。enable_toolset({ name: "..." }) を使うと、実行制御、シーン編集、プロジェクト設定、アニメーション、物理、分析、ひな形作成、テストなど、さらに多くの機能を読み込めます。エディターで開いているシーンへの編集は、ディスク上の .tscn ファイルを黙って上書きするのではなく、ライブツリーと Godot の取り消しシステムを通じて行われます。

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

map_project を実行すると、localhost:6510 でブラウザー上のプロジェクトエクスプローラーが開きます：

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

---

現在の制限事項

• ローカルのみ — localhost 上で動作し、リモート接続には対応していません
• 接続は 1 つのみ — 一度に接続できる Godot インスタンスは 1 つです
• AI の Godot に関する知識には限りがあります — デバッグ、スクリプトの作成、シーンの構築を支援できますが、ガイダンスなしでゲームを完成させることはできません

---

ソースからビルドする

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

その後、npx を使う代わりに、AI クライアントで mcp-server/dist/index.js を指定してください。

---

ライセンス

MIT

---

GitHub · 問題を報告