Godot Agent Loop

一个本地 MCP 服务器，为 AI 助手提供 Godot 4 游戏项目的完整闭环：编写、运行、观察、试玩与验证。

可以做什么

通过目录与通用调用工具发现并执行隐藏能力，默认核心界面公开 16 个工具，完整目录共 56 个（16 个核心加 40 个隐藏）。管理项目生命周期：运行、停止和测试 Godot 项目，包括原生、GUT 与 GdUnit4 测试运行器以及 .NET 构建流程。观察运行中的游戏：截图、场景树、UI、节点信息、错误与日志。以结构化场景和等待进行试玩，并提供鼠标、键盘、触摸和手柄等输入原语。驱动编辑器会话并应用可撤销的复合场景事务，以及通过有界断言、导出就绪检查和完整性分析验证项目。

适用场景

适合助手在构建、调试或测试 Godot 4 游戏项目时使用，需要启动游戏、观察运行、模拟玩家输入并检查结果，而不仅是编辑文件。适用于具备渲染环境的桌面本地开发流程。

运行要求

通过 npx 以 stdio 在本地运行，需要 Node.js 22 或更高版本。需要 Godot Engine 4.7 或更高版本，可选设置 GODOT_PATH 指向可执行文件。C# 项目可选需要 .NET SDK 8 和 Godot .NET 构建。运行游戏和截图需要桌面显示或 Xvfb。可选的编辑器插件需复制到项目并启用，然后重启 Godot。