Godot MCP Omni

戈多特·麦克普欧尼

Codex-optimized MCP服务器，适用于Godot 4.x。它是围绕少数高信号管理器工具而不是数百个窄工具设计的，同时仍然通过动态Godot API转储、无头GDScript操作和可选的编辑器内桥来公开完整的引擎。

设计目标

本版本专为需要紧凑、可靠的本地控制表面的Codex型试剂而设计：

• 零npm运行时依赖：纯Node.js 20+JSON-RPC/MCP stdio实现。
• 小刀具表面：9个工具，每个工具都有明确的行动菜单。
• 无架构膨胀的完整引擎覆盖范围: godot_docs 可以转储/搜索当前Godot二进制文件的API，以及 godot_editor.rpc 可以动态调用编辑器桥功能。
• Codex安全写入：所有文件系统写入都受项目根约束；快照/备份是在编辑之前创建的，生成的桥接令牌将被git忽略。
• 混合动力控制：用于CI/CD沙盒的无头Godot操作；用于实时选择、场景树、检查器、日志和视口相关工作的编辑器桥。
• 结构化结果：每个工具都会返回 content 加 structuredContent，因此模型可以可靠地解析结果。

安装

cd godot-mcp-omni
node src/index.js --doctor

添加 ~/.codex/config.toml:

[mcp_servers.godot]
command = "node"
args = ["/absolute/path/to/godot-mcp-omni/src/index.js"]
startup_timeout_sec = 20
tool_timeout_sec = 120
enabled = true

[mcp_servers.godot.env]
GODOT_PATH = "/absolute/path/to/Godot"
GODOT_MCP_SEARCH_DIRS = "/optional/folder/with/godot"
GODOT_MCP_HOST = "127.0.0.1"
GODOT_MCP_PORT = "8765"
GODOT_MCP_ALLOW_WRITE = "true"
GODOT_MCP_ALLOW_DANGEROUS = "false"

第一个Codex工作流程

1. 询问Codex： Use godot_meta doctor for my project at /path/to/MyGame.
2. 询问Codex： Run godot_editor sync_addon and tell me how to enable the plugin.
3. 打开Godot，启用 戈多法典大桥，然后问Codex： Connect to the Godot editor and read the scene tree.
4. 对于无头工作： Create a Player.tscn with CharacterBody2D root and add a CollisionShape2D child.

godot_editor sync_addon 创造 res://.godot_mcp_token 当否 GODOT_MCP_TOKEN 已配置。默认情况下，包和同步项目会忽略该令牌文件。

对于最新的Godot版本，请选择设置 GODOT_PATH 精确到编辑器二进制文件。如果您保留多个可移植版本，请设置 GODOT_MCP_SEARCH_DIRS 到包含它们的文件夹；服务器探测匹配的Godot二进制文件并选择最新检测到的版本。

要安装用于本地验证或CI的最新官方Godot 4.x稳定编辑器：

npm run godot:install-latest -- --out ./tmp/godot

GitHub工作流程 .github/workflows/latest-godot.yml 运行推送、拉取请求和每日日程。它动态获取最新的官方Godot 4.x稳定版本，并对其运行实时MCP测试套件，因此无需编辑存储库代码即可检查新的稳定版本。

工具表面

• godot_meta：服务器信息、医生、工具帮助、Codex操作配置文件。
• godot_project：项目发现、检查、安全文件读/写/编辑/快照/差异。
• godot_script：脚本列表、读/写、基本语法检查。
• godot_scene：创建/读取/验证场景文件并运行无头节点操作。
• godot_asset：资源扫描、导入、UID查找、文件夹。
• godot_runtime：Godot版本，运行/停止/冒烟/导出/日志捕获。
• godot_editor：同步/连接到编辑器桥，检查树/选择，原始RPC。
• godot_docs：转储/搜索当前Godot API。
• godot_batch：使用错误停止语义运行多步骤工具工作流。

看 docs/ARCHITECTURE.md, docs/TOOLS.md, docs/SECURITY.md，以及 docs/MCP_ARCHITECTURE_REVIEW.md.