启动 Godot 编辑器
为指定项目打开 Godot 编辑器界面。
godot-mcp · Coding-Solo/godot-mcp
godot-mcp 是一个面向 Godot 游戏引擎的 MCP(Model Context Protocol)服务器。按仓库描述,它提供启动 Godot 编辑器、运行项目、捕获调试输出等工具,供支持 MCP 的 AI 客户端调用;README 徽章显示其与 Node.js、TypeScript 相关。具...
godot-mcp 是一个遵循 Model Context Protocol(MCP)规范的服务器实现,作用对象是 Godot 游戏引擎。它的目标并不是直接生成游戏,而是把 Godot 编辑器与项目运行过程变成 AI 代理可以调用的工具集:代理可以启动编辑器、以调试模式跑起项目、读取控制台输出与错误信息,并通过启停操作控制执行流程。README 把这种能力描述为「直接反馈闭环」——代理能亲眼看到自己在真实 Godot 项目里写的代码是否生效、哪里报错,从而改进代码生成与调试辅助的质量。
从仓库徽章与描述看,项目以 Node.js 与 TypeScript 生态实现(仓库主语言标记为 JavaScript),通过 npx @coding-solo/godot-mcp 即可被客户端拉起,无需在本地长期驻留服务。
为指定项目打开 Godot 编辑器界面。
以 debug 模式执行项目。
取回控制台输出与错误消息。
以程序化方式启动与停止 Godot 项目。
获取已安装的 Godot 版本。
在指定目录中查找 Godot 项目。
获取项目结构的详细信息。
以指定根节点类型新建场景;向已有场景添加节点并自定义属性;为 Sprite2D 节点加载精灵与纹理;把 3D 场景导出为可供 GridMap 使用的 MeshLibrary 资源;保存场景,并可选择创建变体。
获取指定文件的 UID;通过重新保存资源来更新 UID 引用。
README 说明服务器对复杂操作采用「打包 GDScript」的方式,分两层:
godot_operations.gd 处理。该脚本以 JSON 形式接收操作类型与参数,因此可以在不为每种操作生成临时文件的前提下,动态执行多种操作。
使用前需要准备三样东西:
在 Claude Code 中只需一条命令注册服务器:
claude mcp add godot -- npx @coding-solo/godot-mcp
重启 Claude Code 后即可使用相关工具。若需要指定引擎路径或打开调试日志,可附加环境变量:
claude mcp add godot -e GODOT_PATH=/path/to/godot -e DEBUG=true -- npx @coding-solo/godot-mcp
其他客户端采用通用 MCP 配置格式,命令为 npx,参数为 @coding-solo/godot-mcp,并在 env 中按需填写 GODOT_PATH 与 DEBUG。README 分别给出了 Cline(写入 cline_mcp_settings.json,含 autoApprove 工具白名单)与 Cursor(设置界面手动添加,或在项目内创建 .cursor/mcp.json)的具体步骤。
若希望从源码使用,可克隆仓库后执行 npm install 与 npm run build,再把 MCP 客户端指向 build/index.js,替代 npx 方式。
| 变量 | 说明 |
|---|---|
GODOT_PATH |
Godot 可执行文件路径,用于覆盖自动探测结果 |
DEBUG |
设为 "true" 时开启服务器端详细调试日志 |
GODOT_PATH 指向 Godot 可执行文件。project.godot 文件的目录。npm install 确保依赖完整。本项目采用 MIT 许可证,详见仓库中的 LICENSE 文件。
Hypersomnia 是 TeamHypersomnia 用 C++ 从零编写的一款多人俯视角(top-down...
NBlood 是用 EDuke32 引擎技术与开发思路对 Build 引擎游戏所做的逆向工程移...
micropolisJS 是把 Micropolis(开源版《模拟城市》类城市模拟游戏)移植到 J...
Frogatto & Friends 是一款 2D 横版动作冒险游戏,主角是一只青蛙;开发团队...
id Software 以 GPL 许可证发布的《雷神之锤3竞技场》(Quake III Arena)源...