虚幻编辑器交互服务

UE-MCP是一个基于FastMCP的服务,允许AI助手通过Python远程执行协议与Unreal Editor交互。

  • by chengdagong
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 chengdagong/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

许可证

麻省理工学院