UE MCP

UE-MCP

用于虚幻编辑器交互的MCP服务器。

概述

UE-MCP是 FastMCP-基于MCP服务器，使AI助手能够通过Python远程执行协议与虚幻编辑器进行交互。

特性

• 项目隔离：每个MCP服务器实例都绑定到一个UE5项目（从工作目录中自动检测到）
• 托管编辑器生命周期：服务器管理编辑器进程并确保退出时的清理
• 自动配置：自动配置Python插件和远程执行设置
• 远程执行：通过socket协议在编辑器中执行Python代码

安装

pip install -e .

用法

从UE5项目目录运行服务器：

cd /path/to/your/ue5/project
ue-mcp

或与FastMCP一起使用：

fastmcp run ue_mcp.server:mcp

MCP工具

• editor.launch(additional_paths, wait, wait_timeout) -启动虚幻编辑器（默认同步）
• editor.status() -获取编辑器状态
• editor.stop() -停止编辑器
• editor.execute(code) -在编辑器中执行Python代码
• editor.configure() -检查/修复项目配置
• project.build(target, configuration, platform, clean, wait, verbose) -使用UnrealBuildTool构建UE5项目

Claude代码配置

添加到您的 .claude/settings.json:

{
  "mcpServers": {
    "ue-mcp": {
      "command": "ue-mcp"
    }
  }
}

需求

• Python>=3.10
• 带有Python插件的虚幻引擎5.x
• FastMCP>=2.0.0

许可证

麻省理工学院