一个轻量级、零占用的TypeScript MCP服务器，让AI助手驱动Godot 4.x游戏引擎。
概览
一个轻量级MCP服务器，将全面的无头编辑与Godot 4.x项目的全运行时控制结合起来。场景、节点、自动加载和验证操作涵盖了引擎中最细分的角落之外的所有操作;运行时桥接器增加了截图、输入模拟、界面发现以及与运行场景树相关的实时GDScript。 AI不仅会写你的游戏，它还能检查自己的工作。 - — 场景、节点、脚本、信号、验证、无编辑器窗口 - — 截图、输入模拟、UI发现、实时GDScript以及对运行游戏的功能配置文件 - — 无Godot插件，无项目提交，关机时自动清理 大多数提供运行时支持的 Godot MCP 服务器作为 Godot 插件发布，安装到项目中，承诺版本控制，并作为依赖管理。使用 npx，无需安装或安装。 可以把它想象成Playwright MCP，但是为Godot设计的。
概述（AI 翻译）
一个轻量级MCP服务器，为AI代理提供与Godot游戏引擎交互的工具。具备全面的无头编辑和对Godot 4.x项目的完整运行时控制。场景、节点、自动加载和验证操作涵盖了除引擎中最小众角落外的所有操作;运行时桥增加了截图、输入模拟、界面发现以及与运行场景树的实时GDScript。
AI不仅会写你的游戏，它还能检查自己的工作。
- 无头编辑：场景、节点、脚本、信号、验证，无编辑器窗口
- 运行时控制：截图、输入仿真、UI发现、实时GDScript以及对运行游戏的功能分析
- 零足迹：无Godot插件，无项目提交，关机自动清理
不需要插件。 大多数提供运行时支持的 Godot MCP 服务器作为 Godot 插件发布，安装到项目中，承诺版本控制，并作为依赖管理。使用 npx，无需安装或设置。
可以把它想象成Playwright MCP，但是为Godot设计的。
本页由 AI 翻译，技术细节请以原文为准。
README
以下为原文 README 节选，完整内容请查看原文。
Godot MCP Runtime
A lightweight MCP server that gives AI agents the tools to interact with the Godot game engine. Features comprehensive headless editing and full runtime control over a Godot 4.x project. Scene, node, autoload, and validation ops cover everything short of the most niche corners of the engine; the runtime bridge adds screenshots, input simulation, UI discovery, and live GDScript against the running scene tree.
The AI doesn’t just write your game, it can check its work.
- Headless editing: scenes, nodes, scripts, signals, validation, no editor window
- Runtime control: screenshots, input simulation, UI discovery, live GDScript, and function profiling against the running game
- Zero footprint: no Godot addon, no project commits, auto-cleanup on shutdown
No addon required. Most Godot MCP servers that offer runtime support ship as a Godot addon, something you install into your project, commit to version control, and manage as a dependency. Use npx and there’s no install or setup needed.
Think of it as Playwright MCP, but for Godot. This does the same thing for games: run the project, take a screenshot, simulate input, read what’s on screen, execute a script against the live scene tree. The agent closes the loop on its own changes rather than handing off to you to verify.
[!NOTE] This is not a playtesting replacement. It doesn’t catch the subtle feel issues that only a human notices, and it won’t tell you if your game is fun. What it does is let an agent confirm that a scene loads, a button responds, a value updated, a script ran without errors. The ability to check work is crucial for AI driven workflows.
Contents
安装
npx -y godot-mcp-runtime配置
{
"mcpServers": {
"godot": {
"command": "npx",
"args": ["-y", "godot-mcp-runtime"],
"env": {
"GODOT_PATH": "<path-to-godot-executable>"
}
}
}
}