Ue Cortex

UECortex

运行完整虚幻引擎的原生虚幻引擎5插件 MCP（模型上下文协议） 虚幻编辑器内的服务器。直接从Claude Code、VS Code或任何MCP客户端控制您的项目——没有Python sidecar，没有Node.js进程，没有外部依赖。

169个内置工具 跨17个类别，加上Python支持的动态工具层。

______________________________________________________________________

快速开始

1.安装

复制 UECortex 将文件夹放入项目的 Plugins/ 目录并在您的 .uproject:

{
  "Name": "UECortex",
  "Enabled": true
}

重新打开项目。服务器在编辑器启动时自动启动。

2.连接

克劳德代码：

claude mcp add uecortex --transport http http://localhost:7777/mcp

VS Code (.vscode/mcp.json):

{ "servers": { "uecortex": { "url": "http://localhost:7777/mcp" } } }

克劳德桌面版 (claude_desktop_config.json):

{ "mcpServers": { "uecortex": { "url": "http://localhost:7777/mcp" } } }

健康检查：

GET http://localhost:7777/health

______________________________________________________________________

工具类别

元

在深入了解完整的工具列表之前，先了解可用的工具。

______________________________________________________________________

级别和演员

生成、移动、删除和检查当前级别中的参与者。

______________________________________________________________________

蓝图

以编程方式创建和连接蓝图资源。

______________________________________________________________________

C++代码生成

生成C++源文件并触发编辑器重新编译。

______________________________________________________________________

渲染和材质

在运行时控制管腔、Nanite、阴影、后处理、雾、天空和材质。

______________________________________________________________________

样条曲线和体积

构建样条线路径并放置触发/阻止体积。

______________________________________________________________________

共轭梯度 *（需要程序内容生成插件）*

构建并执行程序级填充的PCG图。

______________________________________________________________________

游戏玩法能力系统 *（需要GameplayAbilities插件）*

连接GAS组件、能力、属性和游戏标签。

______________________________________________________________________

尼亚加拉视觉特效

生成、配置和控制Niagara粒子系统。

______________________________________________________________________

动画

构建动画蓝图、状态机，并跨骨架重定向动画。

检查

构建动画蓝图

IK 重定向 *（需要IKRig插件）*

维护

动画蓝图工作流程： 添加变量→ 添加状态机→ 添加状态→ 指定动画→ 添加过渡→ 编译 → 设置转换条件→ 再次编译。编译必须在 anim_set_transition_condition 因此变量getter可以解析其类型。 对于标准运动，请使用 anim_create_locomotion_setup 在一次调用中完成上述所有操作（包括Speed和IsInAir的EventGraph连接）。

______________________________________________________________________

UMG小部件

创建并填充小部件蓝图UI。

______________________________________________________________________

定序器

使用摄影机剪辑、轨迹和关键帧构建电影级序列。

______________________________________________________________________

资产管理

浏览、移动、复制、删除和迁移内容浏览器资产。

______________________________________________________________________

视口和输入

捕获屏幕截图并以编程方式驱动编辑器UI。

______________________________________________________________________

Fab市场

在编辑器内搜索和检查Fab市场中的资产。

每个会话加载一次动态工具：

python_reload_tools_from_file  →  Scripts/fab_tools.json

购买同意政策： fab_get_asset 这只是信息。每个响应都包含一个明确的 CONSENT REQUIRED 通知。未经用户明确确认，人工智能代理不得触发购买、添加到购物车或任何付款操作。

______________________________________________________________________

Python和动态工具

在编辑器上下文中执行Python，并在运行时注册新工具，而无需重新编译。

示例——在运行时注册一个工具：

{
  "name": "python_register_tool",
  "arguments": {
    "name": "count_actors",
    "description": "Count all actors in the current level.",
    "code": "import unreal\nactors = unreal.get_editor_subsystem(unreal.EditorActorSubsystem).get_all_level_actors()\n_mcp_result = f'{len(actors)} actors'"
  }
}

工具以如下方式接收其论点 _mcp_params （dict）并通过赋值返回结果 _mcp_result （字符串）。

从JSON文件批量加载：

[
  { "name": "tool_a", "description": "...", "code": "..." },
  { "name": "tool_b", "description": "...", "code": "..." }
]

______________________________________________________________________

可选插件依赖关系

某些类别仅在启用插件时激活：

所有其他类别无条件加载。

______________________________________________________________________

建筑

• 运输： HTTP+SSE已打开 localhost:7777
• 协议： MCP 2024-11-05/JSON-RPC 2.0
• 发动机版本： UE 5.6+（兼容5.7）
• 模块类型： 编辑器插件， PostEngineInit
• 螺纹： HTTP处理程序在游戏线程tick上运行-所有UE API调用都是直接的，不是 AsyncTask 包装器

模块布局