# UE-MCP
MCP server for Unreal Editor interaction.
## Overview
UE-MCP is a [FastMCP](https://github.com/jlowin/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
```bash
pip install -e .
```
## Usage
Run the server from a UE5 project directory:
```bash
cd /path/to/your/ue5/project
ue-mcp
```
Or use with FastMCP:
```bash
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`:
```json
{
"mcpServers": {
"ue-mcp": {
"command": "ue-mcp"
}
}
}
```
## Requirements
- Python >= 3.10
- Unreal Engine 5.x with Python plugin
- FastMCP >= 2.0.0
## License
MIT
