UEMCP は、Python エディタ プラグインから MCP サーバー (Node.js) を分離する 2 層のアーキテクチャにより、Unreal Engine と AI アシスタントをブリッジし、Unreal Engine エディタのリモート展開を可能にします。 この実装は、一般的なUE Python API操作の周りの最適化されたラッパーを提供し、最大85%のコード生成を削減します。 リポジトリには、AIクライアントの自動設定、包括的な開発コンテキスト、および強化されたUEワークフロー用の3つのClaudeエージェントが含まれます。 パッケージマネージドMCPサーバーとは異なり、このリポジトリは、最大のカスタマイズと開発の柔軟性のためにクローン化され、潜在的にフォークされるように設計されています。

すぐにスタート(2分)

セットアップスクリプトは自動的に:

• ✅ 必要に応じてNode.jsをチェックしてインストールします(Homebrew、apt、yum、nvm)
• ✅ 依存関係をインストールし、サーバーをビルドする
• ✅AI開発ツールの検出と構成(Claude Desktop、Claude Code、Amazon Q、Gemini Code Assist、OpenAI Codex)
• ✅ Unreal Engine プロジェクトパスを設定する
• ✅ オプションでUEMCPプラグインをプロジェクトにインストールします

スクリプトは、インストールしたAIツールを検出し、設定する機能を提供します。 -Claudeデスクトップ&クロードコード:ネイティブMCPサポート

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