STARWARCLOUD STARWAR.AI
返回市场
戈多特-MCP

戈多特-MCP

作者：Coding-Solo1115 星标更新：2025-08-10
安装使用来源：spider==github.com

项目介绍

Godot MCP

Github-sponsors

Made with Godot 

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

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

一个用于与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": ["/绝对路径/to/godot-mcp/build/index.js"],
      "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"
      ]
    }
  }
}

选项B：使用Cursor配置

使用Cursor UI：

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

使用项目特定配置：

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

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/绝对路径/to/godot-mcp/build/index.js"],
      "env": {
        "DEBUG": "true"                  // 启用详细日志
      }
    }
  }
}

第三步：可选环境变量

您可以使用以下环境变量自定义服务器行为：

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

示例提示

一旦配置完成，您的AI助手将在需要时自动运行MCP服务器。您可以使用以下提示：

"为我在/path/to/project的项目启动Godot编辑器"

"运行我的Godot项目并显示任何错误"

"获取有关我Godot项目结构的信息"

"分析我的Godot项目结构并提出改进建议"

"帮我调试这个错误：[粘贴错误]"

"编写一个带有双跳和墙滑动功能的角色控制器GDScript"

"在我的Godot项目中创建一个带有Player节点的新场景"

"向我的玩家场景添加一个Sprite2D节点，并加载角色纹理"

"将我的3D模型导出为MeshLibrary供GridMap使用"

"为我的游戏主菜单创建一个带有按钮和标签的UI场景"

"获取我Godot 4.4项目中特定脚本文件的UID"

"在升级到4.4后更新我Godot项目的UID引用"

实现细节

架构

Godot MCP服务器使用捆绑的GDScript方法处理复杂操作：

  1. 直接命令：简单的操作，如启动编辑器或获取项目信息，直接使用Godot内置的CLI命令。
  2. 捆绑操作脚本：复杂的操作，如创建场景或添加节点，使用一个单一的综合GDScript文件（godot_operations.gd），该文件处理所有操作。

这种架构提供了几个优点：

  • 无需临时文件：消除了对临时脚本文件的需求，保持系统干净
  • 简化代码库：将所有Godot操作集中在一个（相对）组织良好的文件中
  • 更好的维护性：更容易添加新操作或修改现有操作
  • 改进的错误处理：在整个操作中提供一致的错误报告
  • 减少开销：最小化文件I/O操作，提高性能

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

故障排除

  • 未找到Godot：设置GODOT_PATH环境变量指向您的Godot可执行文件
  • 连接问题：确保服务器正在运行并重启您的AI助手
  • 无效项目路径：确保路径指向包含project.godot文件的目录
  • 构建问题：确保运行npm install安装所有依赖项
  • 针对Cursor的具体问题：
    • 确保MCP服务器出现在Cursor设置中并已启用（设置 > MCP）
    • MCP工具只能使用代理聊天配置文件运行（Cursor Pro或Business订阅）
    • 使用“Yolo模式”自动运行MCP工具请求

许可证

此项目根据MIT许可证发布 - 查看LICENSE文件了解详情。

MseeP.ai安全评估徽章