UEMCP - Unreal Engine Model Context Protocol

UEMCP bridges AI assistants with Unreal Engine through a two-tier architecture that separates the MCP server (Node.js) from the Python Editor Plugin, enabling remote deployment of Unreal Engine editors. This implementation provides optimized wrappers around common UE Python API operations, reducing code generation by up to 85%. The repository includes automated setup for AI clients, comprehensive development context, and three specialized Claude agents for enhanced UE workflows. Unlike package-managed MCP servers, this repo is designed to be cloned and potentially forked for maximum customization and development flexibility.

🚀 Quick Start (2 minutes)

# Clone and setup
git clone https://github.com/atomantic/UEMCP.git
cd UEMCP
./setup.sh

# Restart Claude Desktop or Claude Code and test:
# "List available UEMCP tools"
# "Organize the actors in the current map into a sensible folder structure and naming convention"

The setup script automatically:

• ✅ Checks and installs Node.js if needed (via Homebrew, apt, yum, or nvm)
• ✅ Installs dependencies and builds the server
• ✅ Detects and configures AI development tools (Claude Desktop, Claude Code, Amazon Q, Gemini Code Assist, OpenAI Codex)
• ✅ Sets up your Unreal Engine project path
• ✅ Optionally installs the UEMCP plugin to your project

The script will detect which AI tools you have installed and offer to configure them:

• Claude Desktop & Claude Code: Native MCP support
• Amazon Q: MCP support via ~/.aws/amazonq/agents/default.json
• Google Gemini (CLI & Code Assist): MCP support via ~/.gemini/settings.json
• OpenAI Codex: Trusted projects via ~/.codex/config.toml
• GitHub Copilot: Usage instructions provided

📝 Windows Users

Recommended: Use WSL (Windows Subsystem for Linux)

# Install WSL if you haven't already
wsl --install

# In WSL/Ubuntu terminal:
git clone https://github.com/atomantic/UEMCP.git
cd UEMCP
./setup.sh

Alternative: Git Bash

• Install Git for Windows which includes Git Bash
• Run ./setup.sh in Git Bash terminal

Note: The setup script will copy (not symlink) the plugin to your UE project on Windows to avoid permission issues.

Advanced options:

# Specify UE project (automatically installs plugin via copy)
./setup.sh --project "/path/to/project.uproject"

# Install with symlink for UEMCP plugin development
./setup.sh --project "/path/to/project.uproject" --symlink

# Non-interactive mode (for CI/CD)
./setup.sh --project "/path/to/project.uproject" --no-interactive