WebSocketブリッジを介して、AIエージェントがGodot 4エディタのセッションや実行中のゲームを検査・制御できるようにします。
別名 godotbridge/addon, addon
- スター
- 5
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 1.0.4
- 最終コミット
- 2026年11月1日
- ライセンス
- MIT
GodotBridge MCPとは
WebSocketブリッジを介して、AIエージェントがGodot 4エディタのセッションや実行中のゲームを検査・制御できるようにします。
プロジェクトのREADMEから生成された概要
GodotBridge MCP server について
GodotBridgeは、AIエージェントとGodot 4エディタのセッションとの接続を提供します。ローカルのWebSocketブリッジを使用することで、Claude、Cursor、Windsurfなどのクライアントが開発環境とやり取りできるようになります。開発者はGDScriptプラグインをGodotプロジェクトに直接インストールし、pip経由でPythonベースのMCP serverを実行してリンクを確立します。このセットアップにより、AIはエディタと実行中のゲームインスタンスの両方を同時に管理できます。
本システムは、シーン構築、アニメーション、シェーダー、物理演算などのタスクをカバーする、36のカテゴリに分類された345個のツールを提供します。実行中のゲームをライブで検査するための第2のチャネルを作成するランタイムプローブも含まれています。これにより、エージェントは入力をシミュレートしたり、スクリーンショットを撮ったり、デバッグ作業を行ったりすることが可能になります。プラグインは純粋なGDScriptで記述されているため、コンパイルは不要で、Godot 4.2以降で動作します。
できること
- 1シーン構築の自動化AIエージェントは、専用のツールを使用してGodotエディタ内でシーンを構築し、整理できます。
- 2ゲームのライブデバッグ開発者は、専用のランタイムチャネルを通じて、実行中のゲームの状態を検査するためにAIを利用できます。
- 3プレイヤー操作のシミュレーションAIクライアントは、実行中のゲームセッション内で入力をトリガーして、メカニクスをテストできます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
GodotBridge MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにGodotBridge MCPをインストール
$ claude mcp add addon -- uvx godotbridgeCursorにGodotBridge MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"addon": {
"command": "uvx",
"args": [
"godotbridge"
]
}
}
}VS CodeにGodotBridge MCPをインストール
.vscode/mcp.json
{
"servers": {
"addon": {
"type": "stdio",
"command": "uvx",
"args": [
"godotbridge"
]
}
}
}VS Code CLIにGodotBridge MCPをインストール
$ code --add-mcp '{"name":"addon","type":"stdio","command":"uvx","args":["godotbridge"]}'Claude DesktopにGodotBridge MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"addon": {
"command": "uvx",
"args": [
"godotbridge"
]
}
}
}CodexにGodotBridge MCPをインストール
$ codex mcp add addon -- uvx godotbridgeCodex config.tomlにGodotBridge MCPをインストール
~/.codex/config.toml
[mcp_servers.addon] command = "uvx" args = ["godotbridge"]
Gemini CLIにGodotBridge MCPをインストール
$ gemini mcp add -s user addon uvx -- godotbridgeGemini settings.jsonにGodotBridge MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"addon": {
"command": "uvx",
"args": [
"godotbridge"
]
}
}
}自動チェック
実行日 2026年11月13日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能godotbridge/addon is public and reachablegithub.com/godotbridge/addon ↗合格
- パッケージがこのリポジトリをソースとして指定godotbridge names https://github.com/godotbridge/releases/releases as its sourcepypi.org/project/godotbridge/ ↗検出事項
- ビルドの来歴 (Sigstore 証明)No build attestation published for this release未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-10github.com/godotbridge/addon ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from godotbridge合格
- パッケージおよびその依存関係に重大な勧告なし32 resolved dependencies checked; no critical advisoryosv.dev ↗合格
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るGodotBridge — Godot Editor Plugin
The Godot 4.x editor addon for GodotBridge. This plugin creates a local WebSocket bridge that lets an MCP-speaking AI agent (Claude, Cursor, Windsurf, or any MCP client) inspect and control your Godot editor session and running game.
Features
- 345 tools across 36 categories — scene building, animation, shaders, physics, runtime game control, AI Image Studio, and more
- Real-time bridge — WebSocket connection between the editor and the MCP server
- Runtime probe — a second channel to the running game for live inspection, input simulation, screenshots, and debugging
- Zero compilation — pure GDScript, drop-in plugin
Installation
From Godot Asset Library (recommended)
- Open your Godot project
- Go to AssetLib tab
- Search for GodotBridge
- Click Download → Install
- Enable the plugin: Project → Project Settings → Plugins → GodotBridge → Enable
Manual installation
- Download or clone this repository
- Copy the
addons/godot_mcp_bridgefolder into your Godot project'saddons/directory - Enable the plugin: Project → Project Settings → Plugins → GodotBridge → Enable
Setup
This plugin is the editor-side half of GodotBridge. You also need the MCP server to connect your AI agent:
pip install godotbridge
Then register it with your AI client:
Claude Code:
claude mcp add godot-bridge -- godotbridge
Claude Desktop / Cursor / Windsurf:
Add to your MCP config:
{
"mcpServers": {
"godot-bridge": {
"command": "godotbridge"
}
}
}
For detailed setup instructions, visit godotbridge.com.
How it works
Your AI agent (Claude, Cursor, etc.)
│
│ MCP / stdio
▼
GodotBridge MCP Server (Python)
│
│ WebSocket · ws://127.0.0.1:8765
▼
This plugin (Godot editor)
│
│ WebSocket · ws://127.0.0.1:8766
▼
Your running game (runtime probe)
The editor plugin hosts the WebSocket server. The MCP server connects to it as a client — so the bridge survives your AI session ending and reconnects automatically.
Requirements
- Godot 4.2 or later
- GodotBridge MCP server (Python 3.10+)
License
MIT — see LICENSE for details.
Links
GodotBridge MCPのよくある質問
GodotBridge MCPをClaude Codeに追加するには
ターミナルでclaude mcp add addon -- uvx godotbridgeを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
GodotBridge MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
システム要件は何ですか?
Godot 4.2以降と、Python 3.10以上で動作するGodotBridge MCP serverが必要です。
ブリッジのコンパイルは必要ですか?
いいえ、プラグインは純粋なGDScriptで記述されているため、コンパイルは一切不要です。