Godot MCP Gateway

English | 简体中文

1つのGodotエディタ、複数のAIコーディングエージェント。

Godot MCP Gateway は、Codex、Claude Code、OpenCode、Pi、その他のMCPクライアントが1つのGodotエディタを安全に共有できるようにするローカルコントロールプレーンです。各クライアントは独立したMCPセッションを維持しつつ、マシン全体で動作する単一のGatewayが、エディタの検出、リクエストのルーティング、書き込みのスケジューリング、プレイテストへのアクセス、Godot LSP接続、再接続を管理します。

プロジェクトの状態: 初期開発段階です。v1のGatewayトポロジー、異なるツールのバッチ実行、エディタのアクティビティUIは実装されていますが、まだ安定版のリリースは公開されていません。

なぜGatewayなのか?

ほとんどのGodot MCP統合は、AIクライアントごとに1つのサーバーを起動し、1つのエディタポートを専有します。複数のエージェントが同じプロジェクトで作業するとき、このモデルは脆くなります。このプロジェクトでは、エージェントのセッションとエディタの接続を分離します:

Codex -------- stdio shim --\
Claude Code -- stdio shim ---+-- local IPC -- Gateway -- WebSocket -- Godot Editor
OpenCode ----- stdio shim ---/                   |-- Playtest Runtime
Pi ----------- stdio shim --/                    `-- Godot LSP

GodotプラグインはGatewayへ外向きに接続します。エージェントがGodotのポートプールを専有したり、エディタに直接接続することはありません。

Related MCP server: agent-bus-mcp

ハイライト

• マルチエージェントセッション: すべてのMCPクライアントが、それぞれ独自のアイデンティティ、ライフサイクル、アクティビティストリームを持ちます。

• 単一のエディタ接続: Gatewayがエディタ、ランタイム、LSPのルーティングを一元管理します。

• 順序化された書き込み: 異なるエージェントからのエディタ変更はFIFOでスケジュールされます。

• クロスツールバッチ: batch は異なる種類のMCPツールを順番に実行し、失敗時に停止し、他のエージェントの書き込みが混入するのを防ぎます。

• 可視化された操作: Godot Dock には、接続中のエージェント、キュー中および実行中の作業、バッチの進行状況、最近の結果が表示されます。

• エディタのフォーカス: 成功した変更は、影響を受けたノードを選択してフォーカスできます。

• 完全なツールキット基盤: 上流のGodotツールカタログは、Gatewayアーキテクチャー上でもそのまま利用できます。

要件

• Godot 4.2 以降

• Node.js 22 以降

• npm

ソースから実行する

リポジトリをクローンしてビルドします:

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

addons/godot_mcp_gateway/ をGodotプロジェクトの addons/ ディレクトリにコピーし、プロジェクト設定 → プラグインでGodot MCP Gateway を有効にします。

マシン全体のGatewayをターミナルで起動し、そのまま実行したままにします:

npm run start:gateway

各MCPクライアントが独自のstdioシムを起動するように設定します。/absolute/path/to/godot-mcp-gateway は、クローンしたリポジトリの絶対パスに置き換えてください:

{
  "mcpServers": {
    "godot-mcp-gateway": {
      "command": "node",
      "args": [
        "/absolute/path/to/godot-mcp-gateway/packages/server/dist/index.js",
        "stdio"
      ],
      "env": {
        "GODOT_MCP_PROJECT_PATH": "/absolute/path/to/your-godot-project"
      }
    }
  }
}

MCPクライアントがGodotプロジェクトのルートで起動する場合は、GODOT_MCP_PROJECT_PATH は省略できます。GODOT_MCP_AGENT_NAME を設定すると、Dock に表示されるエージェント名ラベルを上書きできます。

バッチの例

batch ツールは、通常の登録済みツール呼び出しを受け付けます:

{
  "calls": [
    {
      "tool": "scene_get_tree",
      "arguments": { "max_depth": 1 }
    },
    {
      "tool": "project_get_settings",
      "arguments": { "prefix": "application/" }
    }
  ]
}

呼び出しは、通常の検証とツールのパイプラインを順に通過します。実行は最初に失敗またはキャンセルされたステップで停止し、残りのステップは skipped とマークされます。ネストしたバッチと出力の引用は v1 ではサポートされていません。

リポジトリ構成

• addons/godot_mcp_gateway/ — Godotエディタプラグイン、ツールハンドラ、Dock。

• packages/server/ — Gatewayプロセス、stdio MCPサーフェス、IPC、ツールカタログ、スケジューリング、ランタイムルのーティング、LSP管理。

• docs/ — アーキテクチャ、プロトコル、コントリビューター、互換性、ローカルテストのドキュメント。

リポジトリのルートは、プラグインを開発・試動するための小さなGodotプロジェクトでもあります。より詳しいガイドはドキュメントの目次から始めてください。

現在のv1の境界

• 1つのGatewayが、1つのGodotエディタと1つのアクティブなプレイテストのランタイムを受け入れます。

• Gatewayは手動で起動され、フォアグラウンドで実行されます。

• バッチは失敗時に停止し、各変更はそのまま独自のUndoステップを保持します。

• ネストしたバッチと、ステップ出力の参照を考慮した先送りしています。

帰属/ライセンス

このプロジェクトは、NPGameDev 氏による Godot MCP Toolkit と Godot MCP Server のアクティブなフォークです。両者の成熟したツールカタログとエディタ統合が機能の基盤を築いており、本フォークはその周囲の接続トポロジーを変更しています。

ソースコードはMIT Licenseの下で公開されています。保存された上流の著作権表示とサードパーティのクレジットについては、ATTRIBUTIONS.md を参照してください。上流のアートワークを引き継いだアセットは開発用の素材であり、このフォーク独自のブランド素材としてはライセンスされません。ブランド化したリリースを配布する前に、それらを置き換えてください。