# UMG MCP

Winyunq 终极智造

语言 / Language English

© 2026 Winyunq. 保留所有权利。

双回路极速直连安全保护

Official Docs / 模型配置

硬件状态

i9-13900HX | RTX 4060 | 64GB

## 第一章：怎么配置模型（平行四选一）

在 UMG MCP 中，为了让 AI 完美编织 UI，我们设计了四种平行的模型接入机制。您可以根据开发者的实际部署情况（如本地计算或远程 API），在虚幻编辑器的 `Project Settings -> Unreal Motion Graphics MCP` 中进行一键配置。

### 1. 四大平行配置模式详解

#### 01 本地大模型 (LiteRT-LM)

内置免梯

运作原理： 开启此选项（设置 `bEnableLiteRtLm = true`）后，插件将直接拉起内置的 C++ LiteRT 推理引擎。它直接加载保存在插件 `Resources/Models` 目录下的本地模型文件（例如 `gemma-4-E2B-it.litertlm`）。

🛠️ Winyunq 硬件调优建议：

得益于您强大的 i9-13900HX CPU 与 RTX 4060 GPU 硬件：

- 建议将 `LocalModelContextLength`（上下文长度）设为 65536。
- 将 `LocalModelPrefillChunkSize` 设为 4096，以发挥 RTX 4060 大吞吐并行的优势，保障流畅的生成体验。

#### 02 Google 登录账号 (AuthLogin)

一键云连

运作原理： 选择此供应商后，通过虚幻内置的 `UUmgMcpAuthenticationSubsystem` 调起 Google OAuth 2.0 登录流程，完成账号安全授权。插件将直接通过网络请求获取临时的 Access Token 进行鉴权，无缝直连 Google Gemini API，免去手动输入 API Key 的琐碎流程。

#### 03 API 密钥配置 (ApiKey)

高阶自定义

运作原理： 支持配置多组远程大模型平台。系统自带 Google (Gemini API)、ZhipuAI (智谱 AI) 预设，并支持 Custom 模式（可填入任意符合 OpenAI 协议的自定义 Endpoint，如 DeepSeek、本地 OneAPI/LM-Studio 后端）。支持模型配置的多 Tag 调度路由。

#### 04 本地命令行 (Local CLI)

管道直通

运作原理： 专为极致的脚本极客设计。设置首选供应商为 CLI 模式，并在 `LocalCliCommand` 中配置可执行文件名。插件在推进会话时，将在后台启动此控制台进程，以标准输入输出 (StdIn/StdOut) 的管道方式接收和回传大模型数据，实现最底层的完全控制。

### 🔐 API Key 安全防护与非 Git 持久化原理

在团队协作中，最常见的灾难就是**误将包含个人或公司付费 API Key 的配置文件提交到公共 Git 仓库**，导致巨额账单泄露。为此，UMG MCP 插件在底层完美结合了虚幻引擎的安全特性，设计了物理隔离的双重防泄露机制：

##### 属性脱敏：`meta=(Password=true)`

在 `UmgMcpSettings.h` 源码中，API 密钥定义为 `meta=(Password=true)`。这使得虚幻编辑器在 Details 面板展示此属性时，会自动对其执行密码圆点脱敏遮罩，防窥防屏录。

##### 非 Git 持久化路径：`Saved/Config/WindowsEditor/Editor.ini`

该配置类声明为 `UCLASS(Config = Editor, DefaultConfig)`，但所有的 API Key 数据均存放在由 `UPROPERTY(Config)` 修饰的运行时字段中。这表明：

- 当您在编辑器中输入并保存配置时，它**绝不**会写入项目的 `Config/DefaultEditor.ini`（该文件通常需要提交至 Git 跟踪）；
- 而是自动持久化在项目根目录下的 `Saved/Config/WindowsEditor/Editor.ini` 本地缓存中。
- 根据虚幻的工业标准，整个 `Saved/` 目录在 Git 的 `.gitignore` 中是**默认且强制物理屏蔽**的！

#### 📸 物理截图占位（双击此卡片查看截图详情）

[IMAGE_PLACEHOLDER: Unreal Settings - DeveloperSettings Tab for Unreal Motion Graphics MCP]

请运行虚幻编辑器，打开项目设置，截图“Unreal Motion Graphics MCP”属性窗口并替换此占位。