Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

190 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

UE-MCP

MCP server for Unreal Editor interaction.

Overview

UE-MCP is a FastMCP-based MCP server that enables AI assistants to interact with Unreal Editor through the Python remote execution protocol.

Features

  • Project Isolation: Each MCP server instance is bound to a single UE5 project (auto-detected from working directory)
  • Managed Editor Lifecycle: Server manages the editor process and ensures cleanup on exit
  • Auto Configuration: Automatically configures Python plugin and remote execution settings
  • Remote Execution: Execute Python code in the editor via socket protocol

Installation

pip install -e .

Usage

Run the server from a UE5 project directory:

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

Or use with FastMCP:

fastmcp run ue_mcp.server:mcp

MCP Tools

  • editor.launch(additional_paths, wait, wait_timeout) - Launch Unreal Editor (synchronous by default)
  • editor.status() - Get editor status
  • editor.stop() - Stop the editor
  • editor.execute(code) - Execute Python code in the editor
  • editor.configure() - Check/fix project configuration
  • project.build(target, configuration, platform, clean, wait, verbose) - Build the UE5 project using UnrealBuildTool

Claude Code Configuration

Add to your .claude/settings.json:

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

Requirements

  • Python >= 3.10
  • Unreal Engine 5.x with Python plugin
  • FastMCP >= 2.0.0

License

MIT

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages