Open Godot MCP
開源、免費、全功能的 Model Context Protocol(MCP)server,讓 AI 自主開發、測試、除錯 Godot 遊戲——包含真實遊戲操作、確定性 playtesting、連線遊戲測試、DAP 除錯、LSP 整合、Token 效率設計。100% MIT 授權,無 freemium,無付費牆。
接入你的智能体
从发布者处安装。不是 PlugMCP 端点。
远程 URL 还是本机命令? 两种安装方式的区别
来自发布者
開源、免費、全功能的 Model Context Protocol(MCP)server,讓 AI 自主開發、測試、除錯 Godot 遊戲——包含真實遊戲操作、確定性 playtesting、連線遊戲測試、DAP 除錯、LSP 整合、Token 效率設計。100% MIT 授權,無 freemium,無付費牆。
Open-source MCP server for AI-autonomous Godot game development. Deterministic playtesting, multiplayer testing, DAP debugging, LSP, token-efficient. 100% MIT.
Languages: 繁體中文(本檔)| English | 简体中文 | 日本語 | 한국어 | Español | Français | Deutsch | Русский | Português-BR | Polski | Italiano | Türkçe | ภาษาไทย | Tiếng Việt | Bahasa Indonesia | Українська | Nederlands | العربية | हिन्दी
Open Godot MCP 是一個開源的 Model Context Protocol server,將 AI 程式助手(Claude、GPT、Cursor、Windsurf 等)連接到 Godot Engine 編輯器。它讓 AI 能夠寫程式、運行遊戲、測試玩法、在斷點除錯、檢查變數、驗證修復——全部自主完成,無需人工介入。
與只能編輯場景的現有 Godot MCP 不同,Open Godot MCP 讓 AI 真的玩遊戲——透過確定性 playtesting(凍結時鐘 → step 時間 → 觀察狀態 → 驗證結果)。它是唯一支援連線遊戲測試、DAP 除錯器整合、LSP 程式碼智慧的 Godot MCP。
市面上的 Godot MCP 都有缺陷:
AI 不只寫程式,還能自己玩遊戲驗證修復:
godot_game play frozen=true # 啟動遊戲(凍結時鐘)
godot_exec eval code="GameState.wave = 3" # 設定測試場景
godot_game_time step_until "boss.size() >= 1" # 等待 Boss 出現
godot_runtime_state digest # 觀察狀態(JSON,不燒 vision token)
godot_game_time step ms=500 + dodge input # 播放關鍵時刻
godot_screenshot game # 只在值得時截圖
所有現有 Godot MCP 都缺的能力:
godot_network launch_instance role="host" # 啟動伺服器
godot_network launch_instance role="client" # 啟動客戶端
godot_network network_condition latency=200 # 注入 200ms 延遲
godot_network sync_state # 驗證多實例同步
godot_network simulate_peer count=50 # 壓力測試 50 個 peer
每個工具都有省 token 設計:
cleanup action,防止垃圾檔累積。v0.1.6+ 可直接在 Dock 面板調整保留數和時數(per-project)解決現有 MCP「時常連線不到」的問題:
MCP stdio 架構下,每個 AI client session 各自啟動一個 server 行程。Windows 殺 parent 時不會關閉 child 的 inherited stdin handle,導致孤兒行程永遠活著、越積越多。
--shutdown-all:更新前一鍵清除所有殘留行程,解鎖 .exe,不需重開電腦# 更新前清場(殺所有殘留 server 行程)
open-godot-mcp --shutdown-all
# 再跑更新
uv sync
5 個 AI 工具可選啟用,預設關閉。在 dock 面板填入 API key + 勾選子功能後才動態註冊,未啟用時 AI 工具清單完全看不到。支援多 key 輪換(429/402/401 自動換 key)+ 5xx 自動重試。
Config 預設存於 ~/.open_godot_mcp/config.json(user home,不在 git repo 內)。v0.1.6+ 可在 Dock 面板勾選「使用專案級設定檔」,改存於 <專案>/.open_godot_mcp/config.json(per-project,不同專案可用不同 API key)。詳見 Docs/02-Tools/Agnes-NVIDIA.md。
uv tool install open-godot-mcp
# 或
pip install open-godot-mcp
{
"mcpServers": {
"open-godot-mcp": {
"command": "open-godot-mcp"
}
}
}
Addon 會自動注入。開啟 AI Client 開始用。
完整安裝指南見 Docs/06-Installation/Guide.md。
~35 tools(含 5 個動態註冊的 Agnes/NVIDIA AI 工具),~130 actions。read/write 分離設計。
完整 API 見 Docs/02-Tools/Index.md。
Model Context Protocol 是一個開放標準,讓 AI 助手連接外部工具和資料來源。Open Godot MCP 是一個 MCP server,將 AI 連接到 Godot Engine 編輯器。
Godot 4.5 及更新版本。Addon 使用 Godot 4.x API,包含 EditorDebuggerPlugin、EditorInspector、debugger message channel。
任何 MCP 相容客戶端:Claude Desktop、Cursor、Windsurf、VS Code(MCP 擴充)、Continue、Zed,以及任何支援 Model Context Protocol 標準的客戶端。
是的。C# 語法檢查和編譯驗證已支援。見 Docs/08-CSharp-Support/。
Open Godot MCP 是唯一支援連線遊戲測試、DAP 除錯器整合(斷點、stack trace、變數檢查)、LSP 程式碼智慧的 Godot MCP。它也有最全面的 Token 效率設計。
是的。100% MIT 授權,無 freemium 模式,無付費牆,無功能限制。所有功能對所有人免費。
是的。透過確定性 playtesting,AI 可以凍結遊戲時鐘、精確 step 時間、注入測試場景、模擬玩家輸入、以 JSON 觀察遊戲狀態、截圖——全部用來驗證程式碼變更是否正確。
Open Godot MCP 可以啟動多個 Godot 實例(host + client)、模擬 peer、注入網路條件(延遲、封包遺失)、驗證遊戲狀態跨實例同步。
5 個可選啟用的 AI 工具(視覺、產圖、產影片),整合 Agnes AI API 和 NVIDIA NIM API。預設關閉,需在 dock 面板填入 API key + 勾選子功能後才動態註冊。支援多 key 輪換和 5xx 自動重試。兩家 API 都有免費額度。詳見 Docs/02-Tools/Agnes-NVIDIA.md。
Open Godot MCP 讓 AI 在 Godot 編輯器和遊戲執行時內操作,以下是安全相關資訊:
所有 WebSocket 連線綁定 127.0.0.1(localhost only),不暴露到 LAN/WAN。Bridge 支援 auth_token 認證(在 Godot EditorSettings 設定 open_godot_mcp/security/auth_token),未設定 token 時接受所有本機連線。
Agnes / NVIDIA API key 存於 ~/.open_godot_mcp/config.json(user home,不在 git repo 內)。檔案權限設為 0o600(POSIX,僅 owner 可讀寫)。.gitignore 全域排除 **/config.json,防止意外提交。若使用專案級設定檔,內建 git safety check 會偵測 config 是否在 git repo 內並警告。
godot_exec eval 允許 AI 在運行中的遊戲執行任意 GDScript。這是確定性 playtesting 的必要功能(AI 需要設定測試場景、呼叫方法、斷言條件)。GDScript 受 Godot sandbox 限制,但仍可存取檔案系統和網路。
如果不需要 eval,可用 --no-eval 關閉:
open-godot-mcp --no-eval
# 關閉 eval(禁止 AI 執行任意 GDScript)
open-godot-mcp --no-eval
# 唯讀模式(禁止所有寫入操作)
open-godot-mcp --read-only
# 限制檔案存取範圍(只允許存取指定目錄)
open-godot-mcp --allowed-paths /path/to/project
# 同時使用三層防護
open-godot-mcp --no-eval --read-only --allowed-paths /path/to/project
AI 可能被 prompt injection 攻擊(例如遊戲內文字、網頁內容、使用者輸入中藏惡意指令)。建議:
--no-eval + --allowed-paths~/.open_godot_mcp/config.json 的 API key 是否外洩完整文件索引見 Docs/README.md。按資料夾分類,解耦合設計。
Open Godot MCP 站在巨人的肩膀上,截優去短自以下專案:
MIT——100% 開源,所有功能免費,無 freemium,無付費牆。
Open-source MCP server for AI-autonomous Godot game development. Deterministic playtesting, multiplayer testing, DAP debugging, LSP, token-efficient. 100% MIT.
工具
暂无工具列表。远程服务器在首次健康检查后会获得工具列表。
常见问题
在本页复制适用于 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 配置。它使用发布者的安装方式,而不是 PlugMCP 代理。
此记录未列出必需的环境变量。
Open Godot 通过 stdio 在本地运行。
上次检查时间:2026-10-27。 Open-source MCP server for AI-autonomous Godot game development. Deterministic playtesting, multiplayer testing, DAP debugging, LSP, token-efficient. 100% MIT.