Godot MCP

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

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

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

简介

Godot MCP 使 AI 助手能够启动 Godot 编辑器、运行项目、捕获调试输出并控制项目执行——所有这些都通过一个标准化的接口完成。

这种直接的反馈循环有助于像 Claude 这样的 AI 助手理解在真实的 Godot 项目中什么有效，什么无效，从而提高代码生成和调试辅助的质量。

特性

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

要求

• 在您的系统上安装 Godot 引擎
• Node.js 和 npm
• 支持 MCP 的 AI 助手（例如 Cline、Cursor 等）

安装和配置

第一步：安装和构建

首先，克隆仓库并构建 MCP 服务器：

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

第二步：与您的 AI 助手进行配置

选项 A：使用 Cline 配置

将以下内容添加到您的 Cline MCP 设置文件中（~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json）：

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/absolute/path/to/godot-mcp/build/index.js"],
      "env": {
        "DEBUG": "true"                  // Optional: Enable detailed logging
      },
      "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"
      ]
    }
  }
}

选项 B：使用 Cursor 配置

使用 Cursor UI：

1. 转到 Cursor 设置 > 功能 > MCP
2. 点击 + 添加新的 MCP 服务器 按钮
3. 填写表单：
   • 名称: godot（或任何你喜欢的名称）
   • 类型: command
   • 命令: node /absolute/path/to/godot-mcp/build/index.js
4. 点击“添加”
5. 您可能需要点击 MCP 服务器卡片右上角的刷新按钮以填充工具列表

使用特定于项目的配置：

在您的项目目录中创建一个名为 .cursor/mcp.json 的文件，内容如下：

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/absolute/path/to/godot-mcp/build/index.js"],
      "env": {…