AI导哈

UE蓝图模型协议服务器

用于AI辅助Unreal Engine 5.7+蓝图操作的模型上下文协议服务器，支持持久TCP连接和自动保存功能。

  • by lilklon
  • C++
  • 本地部署
  • 37 星标
  • 更新于
在 GitHub 查看 lilklon/UEBlueprintMCP

使用说明

UEBlueprintMCP

用于人工智能辅助虚幻引擎5.7+蓝图操作的模型上下文协议（MCP）服务器，具有持久TCP连接和自动保存功能。

特性

  • 60+MCP命令 用于蓝图、材质、小部件、增强输入和编辑器控制
  • 持久TCP连接 -套接字在命令之间保持打开状态（端口55558）
  • 自动保存 -每次成功操作后自动保存脏包
  • 防崩溃保护 -所有操作都通过验证/执行管道进行
  • 基于字符串的解析 -接受蓝图名称、资源路径或引擎类名

支持的操作

类别 命令
蓝图 创建、编译、添加组件、设置属性
图形节点 事件、函数、变量、分支、强制转换、生成
事件源 创建、绑定和调用多播委托
增强输入 创建输入操作、映射上下文、键绑定
材料 创建材质、添加表达式、连接节点、后处理
UMG小部件 创建小部件、添加文本/按钮、绑定事件
编辑 生成演员、视口控制、保存操作

设置

1.安装虚幻插件

复制或符号链接 UnrealPlugin/UEBlueprintMCP/ 到你的项目 Plugins/ 文件夹，然后重新生成。

2.设置Python MCP服务器

cd Python
python -m venv venv
venv\Scripts\activate  # Windows
pip install -r requirements.txt

3.配置MCP客户端

添加到您的项目 .mcp.json:

{
  "mcpServers": {
    "unreal-mcp": {
      "command": "path/to/UEBlueprintMCP/Python/venv/Scripts/python.exe",
      "args": ["-m", "ue_blueprint_mcp.server"]
    }
  }
}

4.发射

  1. 打开虚幻项目（插件在端口55558上启动TCP服务器）
  2. 连接您的MCP客户端（例如，Claude Code /mcp)

建筑

MCP Client (Claude Code, etc.)
    |
    v  MCP Protocol
Python Server (ue_blueprint_mcp)
    |
    v  TCP/JSON (port 55558, persistent)
C++ Plugin (MCPBridge)
    |
    v  Action dispatch
FEditorAction subclasses
    |
    v  Validate -> Execute -> Auto-Save
Unreal Editor

所有编辑器操作都通过 FEditorAction 提供以下功能的子类：

  • 执行前验证
  • 使用描述性消息进行优雅的错误处理
  • 自动跟踪和保存脏包裹

文档

需求

  • 虚幻引擎5.7+
  • Python 3.10+
  • Visual Studio 2022（用于插件构建）

许可证

麻省理工学院

相关 MCP