← 返回目录
G

GladeKit MCP

社区
将 Unity 和 Godot 编辑器无缝接入任意 MCP 兼容的 AI 客户端。
GitHub 源仓库 ↗
★ 205 Stars 分类 · 开发工具 热门 源版本 bb2b4803c906
63FMRS · C
可靠性
8/20
安全与权限
12/20
维护活跃度
13/20
文档质量
16/20
安装易用性
14/20

该服务器功能丰富,是游戏开发领域最全面的 MCP 实现之一,但需要谨慎配置和权限管理。

查看 FMRS 评分方法 →

GladeKit MCP 是一个开源服务器,它允许 Cursor、Claude Code、Windsurf 等 AI 编程助手直接控制 Unity 和 Godot 编辑器。它提供 260+ 个用于 Unity 的细粒度工具,以及 105 个用于 Godot 的本地工具,涵盖场景管理、脚本操作、物理、动画、UI 等领域。该服务器可自动检测正在运行的编辑器,并暴露匹配的工具集。此外,它还提供编辑器感知的系统提示、项目上下文文件(GLADE.md)、脚本语义搜索、技能校准,以及可选的云智能层(RAG 和跨会话记忆)。

工具能力

get_relevant_tools
根据任务描述发现相关工具,并注入 RAG 上下文。
remember_for_session
在当前会话中存储事实,供后续调用使用。
recall_session_memories
检索当前会话中存储的事实。
batch_execute
一次调用执行多个工具步骤。
search_project_scripts
使用 OpenAI 嵌入对项目脚本进行语义搜索。
find_asset
根据描述、类型、风格和许可证搜索免费 CC0 资源。
import_asset
下载、提取并导入 CC0 资源,同时写入许可证侧车文件。
list_imported_assets
列出已导入资源及其许可证信息,用于审计。

安装接入

  1. 安装编辑器桥接器:

- Unity:在 Package Manager 中添加 git URL:https://github.com/Glade-tool/glade-mcp.git?path=/unity-bridge
- Godot (4.3+):下载 com.gladekit.mcp-bridge.zip,解压到 addons/ 目录,并在 Project Settings 中启用插件。

  1. 安装 uv(一次性):

- Mac/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh
- Windows: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

  1. 为您的 AI 客户端添加 MCP 配置,例如:
   {
     "mcpServers": {
       "gladekit-mcp": {
         "command": "uvx",
         "args": ["gladekit-mcp"]
       }
     }
   }
   

对于 Claude Code:运行 claude mcp add --transport stdio gladekit-mcp --scope user -- uvx gladekit-mcp

claude_desktop_config.json
{
  "mcpServers": {
    "gladekit-mcp": {
      "command": "uvx",
      "args": [
        "gladekit-mcp"
      ]
    }
  }
}

选型与风险

适合谁

  • 独立游戏开发者和小团队,希望在 Unity 或 Godot 中使用 AI 辅助开发。
  • 希望将 AI 集成到日常游戏开发工作流中的开发者。
  • 需要快速原型和资源导入的开发者。

不适合谁

  • 大型团队或工作室可能不适用于不受控的 AI 下载资源,但可通过环境变量禁用资源管道。
  • 需要完全离线或严格安全控制的开发环境可能不适合使用可选的云功能。
  • Godot Mono/C# 项目或 Web 导出的目标目前不被支持。

所需权限

  • 通过 HTTP 访问本地编辑器桥接器(Unity 端口 8765,Godot 端口 8766)。
  • 读取和写入项目文件,包括导入资源、创建 GLADE.md 和读取脚本。
  • 可选地使用 OPENAI_API_KEY 或 GLADEKIT_API_KEY 进行云服务调用(语义搜索、RAG、跨会话记忆)。
  • 执行编辑器操作,如创建场景、修改对象和运行编辑器命令。

风险与副作用

  • AI 可能执行意外的编辑器操作,建议先在备份或版本控制下使用。
  • 资源管道仅允许 CC0 许可的资源,但用户需确认许可证。
  • 云功能(若启用)会将数据发送到 OpenAI 或 GladeKit 服务器,存在隐私风险。
  • 桥接器仅在编辑器内运行,不会影响导出游戏,但需要网络端口开放。

常见排障

  1. 检查桥接器是否在预期端口(Unity: 8765, Godot: 8766)监听。
  2. 确保 uv 已安装,或使用 `pip install gladekit-mcp` 并调整命令。
  3. 如果工具未出现在 Claude Code 中,请使用 `get_relevant_tools` 发现扩展工具(默认仅显示约 80 个核心工具)。
  4. GLADE.md 必须放在项目根目录,文件名正确(区分大小写)。
  5. 如果资源管道不工作,检查是否设置了 `GLADEKIT_MCP_DISABLE_ASSET_PIPELINE`。

使用场景

在 AI 助手的对话中直接创建和修改 Unity 场景、游戏对象、脚本和材质。
使用语义搜索快速定位项目中的脚本,即使文件名不匹配。
从 AI 客户端直接导入免费 CC0 资源(如 Kenney 包)到项目中。
在开发过程中自动生成和维护项目上下文(GLADE.md)。
通过技能校准和会话记忆,让 AI 适应您的开发水平和工作流。

支持客户端

Claude Desktop完整支持
Claude Code完整支持
Cursor完整支持
Windsurf完整支持
Cline (VS Code)完整支持
Unity AI Gateway完整支持
VS Code (GitHub Copilot)完整支持