Godot MCP

派生自 Coding-Solo/godot-mcp，提交版本为 1209744 (MIT)。此分支由 @jamesdowzard 独立维护，并增加了 Android 导出验证器支持及其他 AI 友好型工具。上游分支关系已在 git 层面断开；版权/署名根据 MIT 协议保留。

Made with Godot

                           (((((((             (((((((
                        (((((((((((           (((((((((((
                        (((((((((((((       (((((((((((((
                        (((((((((((((((((((((((((((((((((
                        (((((((((((((((((((((((((((((((((
         (((((      (((((((((((((((((((((((((((((((((((((((((      (((((
       (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
     ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
    ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
      (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
        (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         (((((((((((@@@@@@@(((((((((((((((((((((((((((@@@@@@@(((((((((((
         (((((((((@@@@,,,,,@@@(((((((((((((((((((((@@@,,,,,@@@@(((((((((
         ((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((
         ((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((
         (((((((((@@@,,,,,,,@@((((((((@@@@@((((((((@@,,,,,,,@@@(((((((((
         ((((((((((((@@@@@@(((((((((((@@@@@(((((((((((@@@@@@((((((((((((
         (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         @@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@
         ((((((((( @@@(((((((((((@@(((((((((((@@(((((((((((@@@ (((((((((
         (((((((((( @@((((((((((@@@(((((((((((@@@((((((((((@@ ((((((((((
          (((((((((((@@@@@@@@@@@@@@(((((((((((@@@@@@@@@@@@@@(((((((((((
           (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
              (((((((((((((((((((((((((((((((((((((((((((((((((((((
                 (((((((((((((((((((((((((((((((((((((((((((((((
                        (((((((((((((((((((((((((((((((((


                          /$$      /$$  /$$$$$$  /$$$$$$$
                         | $$$    /$$$ /$$__  $$| $$__  $$
                         | $$$$  /$$$$| $$  \__/| $$  \ $$
                         | $$ $$/$$ $$| $$      | $$$$$$$/
                         | $$  $$$| $$| $$      | $$____/
                         | $$\  $ | $$| $$    $$| $$
                         | $$ \/  | $$|  $$$$$$/| $$
                         |__/     |__/ \______/ |__/

一个用于与 Godot 游戏引擎交互的模型上下文协议 (MCP) 服务器。

简介

Godot MCP 使 AI 智能体能够启动 Godot 编辑器、运行项目、捕获调试输出并控制项目执行。这种直接的反馈循环有助于智能体理解 Godot 项目中哪些部分有效，哪些无效，从而提供更好的代码生成和调试辅助。

功能

启动 Godot 编辑器：为特定项目打开 Godot 编辑器
运行 Godot 项目：以调试模式执行 Godot 项目
捕获调试输出：检索控制台输出和错误消息
控制执行：以编程方式启动和停止 Godot 项目
获取 Godot 版本：检索已安装的 Godot 版本
列出 Godot 项目：查找指定目录中的 Godot 项目
项目分析：获取有关项目结构的详细信息
场景管理：
- 使用指定的根节点类型创建新场景
- 向现有场景添加具有可自定义属性的节点
- 将精灵和纹理加载到 Sprite2D 节点中
- 将 3D 场景导出为 GridMap 的 MeshLibrary 资源
- 保存场景，并提供创建变体的选项
UID 管理 (适用于 Godot 4.4+)：
- 获取特定文件的 UID
- 通过重新保存资源来更新 UID 引用

要求

系统中已安装 Godot Engine
Node.js (>=18.0.0) 和 npm
支持 MCP 的 AI 智能体

快速入门

Claude Code

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

完成。重启 Claude Code，您的 Godot MCP 工具即可使用。

使用环境变量：

claude mcp add godot -e GODOT_PATH=/path/to/godot -e DEBUG=true -- npx @coding-solo/godot-mcp

添加到您的 Cline MCP 设置文件 (~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json) 中：

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "DEBUG": "true"
      },
      "disabled": false,
      "autoApprove": [
        "launch_editor",
        "run_project",
        "get_debug_output",
        "stop_project",
        "get_godot_version",
        "list_projects",
        "get_project_info",
        "create_scene",
        "add_node",
        "load_sprite",
        "export_mesh_library",
        "save_scene",
        "get_uid",
        "update_project_uids"
      ]
    }
  }
}

使用 Cursor UI：

前往 Cursor Settings > Features > MCP
点击 + Add New MCP Server 按钮
填写表单：
- Name: godot
- Type: command
- Command: npx @coding-solo/godot-mcp
点击 "Add"
您可能需要点击 MCP 服务器卡片右上角的刷新按钮来填充工具列表

使用项目特定配置：

在您的项目目录中创建 .cursor/mcp.json 文件：

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "DEBUG": "true"
      }
    }
  }
}

对于任何兼容 MCP 的客户端，请使用此配置：

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "GODOT_PATH": "/path/to/godot",
        "DEBUG": "true"
      }
    }
  }
}

环境变量

变量	描述
`GODOT_PATH`	Godot 可执行文件的路径（覆盖自动检测）
`DEBUG`	设置为 `"true"` 以启用详细的服务器端调试日志

git clone https://github.com/Coding-Solo/godot-mcp.git
cd godot-mcp
npm install
npm run build

然后将您的 MCP 客户端指向 build/index.js，而不是使用 npx。

架构

Godot MCP 服务器针对复杂操作使用了捆绑的 GDScript 方法：

直接命令：启动编辑器或获取项目信息等简单操作直接使用 Godot 的内置 CLI 命令。
捆绑操作脚本：创建场景或添加节点等复杂操作使用一个全面的 GDScript 文件 (godot_operations.gd) 来处理所有操作。

捆绑脚本以 JSON 格式接收操作类型和参数，从而允许灵活且动态地执行操作，而无需为每个操作生成临时文件。

故障排除

未找到 Godot：将 GODOT_PATH 环境变量设置为您的 Godot 可执行文件路径
连接问题：确保服务器正在运行并重启您的 AI 助手
项目路径无效：确保路径指向包含 project.godot 文件的目录
构建问题：确保通过运行 npm install 安装了所有依赖项

确保 MCP 服务器在 Cursor 设置中显示并已启用 (Settings > MCP)
MCP 工具只能在 Agent 聊天配置文件中使用 (需要 Cursor Pro 或 Business 订阅)
使用 "Yolo Mode" 自动运行 MCP 工具请求

许可证

本项目采用 MIT 许可证授权 - 有关详细信息，请参阅 LICENSE 文件。

Godot MCP

Godot MCP

简介

功能

要求

快速入门

Claude Code

环境变量

架构

故障排除

许可证

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API