Repolode
Coding-Solo

Coding-Solo/godot-mcp

让 AI 智能体启动 Godot 编辑器、运行项目、获取调试输出并管理场景的 MCP 服务器。

Star
6,154
Fork
490
未关闭 Issue
75
最近提交
6个月前

这是什么?

Godot MCP 是一个 Model Context Protocol 服务器,用于把 AI 智能体连接到 Godot 游戏引擎。智能体可以为指定项目打开 Godot 编辑器,以调试模式运行、启动和停止项目,并读取控制台输出和错误信息。借助这个反馈闭环,智能体能看到项目中实际能跑通的部分,并据此修复代码。

除运行项目外,该服务器还能列出目录中的 Godot 项目、查看项目结构,并返回已安装的 Godot 版本。它可以创建指定根节点类型的场景、添加带自定义属性的节点、为 Sprite2D 加载精灵图和纹理,把 3D 场景导出为 GridMap 可用的 MeshLibrary 资源,并支持保存场景变体。针对 Godot 4.4 及以上版本,还能获取文件的 UID,并通过重新保存资源来更新 UID 引用。

简单操作直接调用 Godot 内置的 CLI,较复杂的场景编辑则通过一个打包的 GDScript 文件完成,参数以 JSON 形式传入。服务器需要 Node.js 18 或更高版本,Claude Code、Cline、Cursor 等客户端均可通过一条 npx 命令完成配置。

核心功能

  • 01为指定项目启动 Godot 编辑器。
  • 02以调试模式运行项目,并捕获控制台输出和错误信息。
  • 03通过程序启动和停止项目。
  • 04创建场景、添加带自定义属性的节点,并保存场景变体。
  • 05将 3D 场景导出为 GridMap 可用的 MeshLibrary 资源。
  • 06为 Godot 4.4 及以上项目获取和更新 UID。

适用场景

  • 让 AI 编程助手运行 Godot 游戏并读取错误信息,从而完成测试和调试。
  • 通过 AI 智能体批量生成 Godot 项目的场景结构和节点。
  • 自动化项目准备工作,例如列出项目和检查 Godot 版本。

快速上手

  1. 1

    在系统上安装 Godot 引擎

  2. 2

    将 MCP 服务器添加到 Claude Code

    claude mcp add godot -- npx @coding-solo/godot-mcp
  3. 3

    重启 Claude Code 以使用 Godot MCP 工具

使用前须知

  • 需要在本地安装 Godot 引擎。
  • UID 管理功能需要 Godot 4.4 或更高版本。

标签

常见问题

godot-mcp 是什么?
让 AI 智能体启动 Godot 编辑器、运行项目、获取调试输出并管理场景的 MCP 服务器。 Godot MCP 是一个 Model Context Protocol 服务器,用于把 AI 智能体连接到 Godot 游戏引擎。智能体可以为指定项目打开 Godot 编辑器,以调试模式运行、启动和停止项目,并读取控制台输出和错误信息。借助这个反馈闭环,智能体能看到项目中实际能跑通的部分,并据此修复代码。
godot-mcp 可以免费使用吗?用的什么许可证?
godot-mcp 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
godot-mcp 还在维护吗?
超过半年未提交。godot-mcp 最近一次提交是在 2026年4月16日。
godot-mcp 适合用来做什么?
让 AI 编程助手运行 Godot 游戏并读取错误信息,从而完成测试和调试。 通过 AI 智能体批量生成 Godot 项目的场景结构和节点。 自动化项目准备工作,例如列出项目和检查 Godot 版本。
godot-mcp 怎么安装和运行?
在系统上安装 Godot 引擎 将 MCP 服务器添加到 Claude Code: claude mcp add godot -- npx @coding-solo/godot-mcp 重启 Claude Code 以使用 Godot MCP 工具
在哪里获取 godot-mcp?
源代码和安装说明在 GitHub 上:https://github.com/Coding-Solo/godot-mcp

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目