← 返回目录

GladeKit MCP

社区

将 Unity 和 Godot 编辑器无缝接入任意 MCP 兼容的 AI 客户端。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 74 / 438
Stars: ★ 209 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Python
凭据: 可选 API Key
许可证: MIT
最近提交: 39 天前
工具数: 8

63FMRS · C

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

最强项 · 文档质量 16/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

12/20

维护活跃度

13/20

文档质量

16/20

安装易用性

14/20

查看各项评分依据

可靠性 8/20: README 与 manifest 描述了一个结构自洽的 stdio/HTTP MCP 服务（PyPI 上的 gladekit-mcp v0.7.22），带 Unity（:8765）/ Godot（:8766）自动探测桥接，主路径看起来可行，且排障与错误路径有文档说明。但审查材料中未包含 CI 工作流、提交的测试或实际源码，因此无法验证初始化与工具列表握手是否真能完成，也无法核实 260+（仓库描述中又写作 235+）的工具数。仓库描述、manifest 与 README 日志示例（桥接 v0.7.6 对服务 0.7.22）之间的轻微不一致也扣了分。按静态校准规则，可靠性上限为 12，评 8 分。
安全与权限 12/20: 在所提供的材料中未发现任何红线行为：没有内嵌的令牌、没有隐蔽外传，README 也明确披露了数据流向（向量化发送到 OpenAI、可选云端层为 api.gladekit.com、GLADE.md 项目上下文注入）。设计上体现了最小权限与确认机制：仅回环地址的 HTTP 绑定并带 DNS 重绑定防护、LAN 暴露需显式开启、资源下载有主机白名单、导入资源要求显式 licenseAcknowledged，并可通过开关停用资源管线。但这些都是 README 自述，无法静态核查防护实现、依赖供应链与云端 API 处理，因此评为 12 分。
维护活跃度 13/20: 多项信号表明项目处于活跃维护状态：MIT 许可、语义化版本 v0.7.22、0 个未解决问题、未归档、有明确的发布产物（Unity UPM 路径、Godot 桥接 zip）以及详细的贡献指南。但所供材料中没有提交历史或日期、发布节奏、依赖更新证据，也没有安全响应渠道（SECURITY.md）；由于节奏与响应速度无法核实，且不确定性应降低分数，故评 13 分。
文档质量 16/20: 文档是分层且相当完整的：覆盖 7 种客户端配置（Claude Code、Cursor、Desktop、Cline、Windsurf、Unity AI Gateway、VS Code）、环境变量表、排障、架构图、安全与资源许可纪律章节，并明确披露了限制（不支持 Godot Mono、Claude Code 128 工具上限、桥接版本漂移）。不足：没有 260+ 工具的逐个参数参考（仅有示例）、没有说明如何获取 GLADEKIT_API_KEY、也没有变更日志。评 16 分。
安装易用性 14/20: 服务端安装步骤清晰且简短：先安装 uv，再向七个已文档化的客户端之一粘贴 stdio 配置（uvx gladekit-mcp）；提供了 Mac/Linux/Windows 变体，并记录了 pip/python 备选方案与 PATH 排障。剩余脆弱点在编辑器侧：必须在 Unity 或 Godot 中安装并运行桥接并监听固定端口，相关故障模式（端口冲突、UPM 缓存漂移）也已记录。按静态校准规则，在没有 CI/测试执行证据的情况下 setup 上限为 15，评 14 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络

适合谁

独立游戏开发者和小团队，希望在 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 服务器，存在隐私风险。
桥接器仅在编辑器内运行，不会影响导出游戏，但需要网络端口开放。

安装接入

准备工作

运行环境：Python

OPENAI_API_KEY 可选密钥在 platform.openai.com/api-keys 获取，启用脚本语义搜索排序。

GLADEKIT_API_KEY 可选密钥 GladeKit 云端服务的密钥，启用RAG知识库与跨会话记忆。

其他可选配置项（4 个）

GLADEKIT_MCP_DISABLE_ASSET_PIPELINE 可选设为1可禁用素材导入相关工具，适合有受管素材流程的团队。

GLADEKIT_MCP_SUPPRESS_BRIDGE_WARNING 可选设为1可静默桥接版本过旧的stderr警告。

UNITY_BRIDGE_URL 可选覆盖Unity桥接地址，默认 http://localhost:8765。

GLADEKIT_MCP_FORCE_ENGINE 可选同时运行两个引擎时，设为 unity 或 godot 以固定检测的引擎。

安装编辑器桥接器：

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 中启用插件。

安装 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"

为您的 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"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "gladekit-mcp": {
      "command": "uvx",
      "args": [
        "gladekit-mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add gladekit-mcp -- uvx gladekit-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

运行 uvx gladekit-mcp 应看到版本横幅；在客户端工具列表中确认出现 get_relevant_tools、find_asset 等工具，并询问项目场景结构以验证 Unity/Godot 桥已连接。

常见排障

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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

我需要一些免费的2D平台器角色和图块素材，帮我找一下（CC0即可）。
把 Platformer Pack Redux 导入到 Assets/Sprites/Platformer/，我接受CC0许可。
帮我审计一下项目里已导入素材的许可证，有没有需要署名的？
搜索一下项目脚本，看看敌人是如何生成的。

工具能力 8

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 只读

列出已导入资源及其许可证信息，用于审计。

使用场景

在 AI 助手的对话中直接创建和修改 Unity 场景、游戏对象、脚本和材质。

使用语义搜索快速定位项目中的脚本，即使文件名不匹配。

从 AI 客户端直接导入免费 CC0 资源（如 Kenney 包）到项目中。

在开发过程中自动生成和维护项目上下文（GLADE.md）。

通过技能校准和会话记忆，让 AI 适应您的开发水平和工作流。

支持客户端

Claude Desktop

Claude Code

Cursor

Windsurf

VS Code

Unity AI Gateway

GitHub Copilot

依据项目文档列出，未经本站实测。

详细介绍

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