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.txt3.配置MCP客户端
添加到您的项目 .mcp.json:
{
"mcpServers": {
"unreal-mcp": {
"command": "path/to/UEBlueprintMCP/Python/venv/Scripts/python.exe",
"args": ["-m", "ue_blueprint_mcp.server"]
}
}
}4.发射
- 打开虚幻项目（插件在端口55558上启动TCP服务器）
- 连接您的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 提供以下功能的子类：
- 执行前验证
- 使用描述性消息进行优雅的错误处理
- 自动跟踪和保存脏包裹
文档
- CLAUDE.md -架构细节和贡献指南
- docs/SKILL.md -Claude Code的完整命令参考
需求
- 虚幻引擎5.7+
- Python 3.10+
- Visual Studio 2022（用于插件构建）
许可证
麻省理工学院