unreal-engine-mcp-server 0.4.7 → 0.5.1

package/CONTRIBUTING.md

@@ -0,0 +1,140 @@
+# Contributing to Unreal Engine MCP Server
+
+Thank you for your interest in contributing! This document provides guidelines and instructions for contributing.
+
+## 📋 Table of Contents
+
+- [Code of Conduct](#code-of-conduct)
+- [Getting Started](#getting-started)
+- [Development Workflow](#development-workflow)
+- [Pull Request Process](#pull-request-process)
+- [Coding Standards](#coding-standards)
+
+## Code of Conduct
+
+Please be respectful and constructive in all interactions. We're building something together.
+
+## Getting Started
+
+### Prerequisites
+
+- **Node.js** 18+ 
+- **Unreal Engine** 5.0-5.7 (for live testing)
+- **Git**
+
+### Setup
+
+1. Fork and clone the repository:
+   ```bash
+   git clone https://github.com/ChiR24/Unreal_mcp.git
+   cd unreal-engine-mcp-server
+   ```
+
+2. Install dependencies:
+   ```bash
+   npm install
+   ```
+
+3. Build the project:
+   ```bash
+   npm run build
+   ```
+
+4. Run smoke tests (no Unreal needed):
+   ```bash
+   npm run test:smoke
+   ```
+
+## Development Workflow
+
+### Branch Naming
+
+Use descriptive branch names:
+- `feat/add-new-tool` - New features
+- `fix/connection-timeout` - Bug fixes
+- `docs/update-readme` - Documentation
+- `refactor/cleanup-bridge` - Code refactoring
+
+### Running Tests
+
+```bash
+# Smoke test (CI-compatible, no Unreal needed)
+npm run test:smoke
+
+# Live tests (requires Unreal Editor running with plugin)
+npm run test:all
+```
+
+### Building
+
+```bash
+npm run build        # Full build (TypeScript + WASM)
+npm run build:core   # TypeScript only
+npm run build:wasm   # WASM only (requires wasm-pack)
+```
+
+## Pull Request Process
+
+### Before Submitting
+
+1. ✅ Run `npm run lint` and fix any issues
+2. ✅ Run `npm run test:smoke` to verify basic functionality
+3. ✅ Update documentation if adding new features
+4. ✅ Update `CHANGELOG.md` under `[Unreleased]`
+
+### PR Title Format
+
+We use [Conventional Commits](https://www.conventionalcommits.org/). PR titles must follow this format:
+
+```
+<type>: <description>
+
+Examples:
+feat: add new animation blending tool
+fix: resolve WebSocket connection timeout
+docs: update installation instructions  
+refactor: simplify blueprint graph handler
+```
+
+**Types:** `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`
+
+### Review Process
+
+1. All PRs require at least one approval
+2. CI must pass (lint, smoke test, CodeQL)
+3. Maintainers may request changes
+
+## Coding Standards
+
+### TypeScript
+
+- Use strict TypeScript (`strict: true`)
+- Prefer `async/await` over raw Promises
+- Use descriptive variable names
+- Add JSDoc comments for public APIs
+
+### C++ (Plugin)
+
+- Follow Unreal Engine coding standards
+- Use `UPROPERTY`/`UFUNCTION` macros appropriately
+- Keep thread safety in mind for async operations
+
+### File Organization
+
+```
+src/
+├── tools/           # MCP tool implementations
+├── automation/      # Unreal bridge logic
+├── utils/           # Shared utilities
+└── services/        # Background services
+
+Plugins/
+└── McpAutomationBridge/  # C++ Unreal plugin
+```
+
+## Questions?
+
+- Open a [Discussion](../../discussions) for questions
+- Open an [Issue](../../issues) for bugs or feature requests
+
+Thank you for contributing! 🎮

package/GEMINI.md

@@ -0,0 +1,115 @@
+# Unreal Engine MCP Server
+
+## Project Overview
+
+The **Unreal Engine MCP Server** (`unreal-engine-mcp-server`) is a comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal Engine via a native automation bridge. It facilitates bidirectional communication between an AI agent (running via MCP) and an active Unreal Engine Editor session.
+
+### Architecture
+
+The system is composed of three main components:
+
+1.  **MCP Server (Node.js/TypeScript):**
+    *   **Role:** The core server that implements the MCP protocol, handles client requests, and orchestrates communication.
+    *   **Location:** `src/`
+    *   **Key File:** `src/index.ts` (Entry point), `src/unreal-bridge.ts` (Connection management).
+    *   **Tools:** Defines MCP tools for Actor manipulation, Asset management, Blueprints, etc. (found in `src/tools/`).
+
+2.  **Unreal Engine Plugin (C++):**
+    *   **Role:** Acts as the receiver and executor within the Unreal Engine process. It runs a WebSocket server to listen for commands from the Node.js server.
+    *   **Location:** `Plugins/McpAutomationBridge/`
+    *   **Key Functionality:** Handles `execute_console_command`, `set_object_property`, and other engine-level operations on the Game Thread.
+    *   **Communication:** Listens on `ws://localhost:8091` (default).
+
+3.  **WebAssembly Module (Rust):**
+    *   **Role:** Provides high-performance utilities for the Node.js server, such as complex property parsing and vector math.
+    *   **Location:** `wasm/`
+    *   **Key File:** `wasm/src/lib.rs`.
+
+## Building and Running
+
+### Prerequisites
+*   Node.js (v18 or higher)
+*   Unreal Engine (5.0-5.7)
+*   Rust (optional, if modifying WASM components)
+
+### Setup
+
+1.  **Install Dependencies:**
+    ```bash
+    npm install
+    ```
+
+2.  **Build the Server:**
+    ```bash
+    npm run build
+    ```
+
+3.  **Build WebAssembly (Optional):**
+    If you are working on the Rust module:
+    ```bash
+    npm run build:wasm
+    ```
+
+4.  **Unreal Plugin Installation:**
+    *   Copy the `Plugins/McpAutomationBridge` folder into your Unreal Project's `Plugins` directory (e.g., `YourProject/Plugins/`).
+    *   Regenerate project files and recompile your Unreal project.
+    *   Enable the plugin in the Unreal Editor if it's not automatically enabled.
+    *   Ensure the plugin is running (it should log "MCP Automation Bridge listening" to the Output Log).
+
+### Running the Server
+To start the MCP server:
+```bash
+npm start
+```
+Or for development with `ts-node`:
+```bash
+npm run dev
+```
+
+### Testing
+The project includes a suite of integration tests located in the `tests/` directory. These scripts act as "fake" MCP clients to verify functionality.
+
+*   **Run All Tests:**
+    ```bash
+    npm test
+    ```
+*   **Run Specific Test:**
+    ```bash
+    npm run test:control_actor
+    npm run test:manage_asset
+    npm run test:wasm
+    ```
+
+## Development Conventions
+
+*   **Language:**
+    *   Server logic is written in **TypeScript**.
+    *   Unreal integration is written in **C++**.
+    *   Performance modules are written in **Rust**.
+*   **Safety:**
+    *   The `UnrealBridge` class (`src/unreal-bridge.ts`) includes safety mechanisms like command throttling and "Safe ViewMode" switching to prevent crashing the engine with invalid commands.
+    *   **Do not** bypass these safety checks when adding new functionality.
+*   **Linting:**
+    *   TypeScript: `npm run lint`
+    *   C++/C#: Scripts provided (`npm run lint:cpp`, `npm run lint:csharp`) rely on external tools like `cpplint` and `dotnet-format`.
+
+## Directory Structure
+
+*   `src/`: Source code for the Node.js MCP server.
+    *   `tools/`: Definitions for MCP tools (Actors, Assets, etc.).
+    *   `resources/`: Definitions for MCP resources.
+    *   `wasm/`: Compiled WebAssembly bindings.
+*   `Plugins/`: Source code for the Unreal Engine C++ plugin.
+*   `wasm/`: Source code for the Rust WebAssembly module.
+*   `tests/`: Integration tests and test runners.
+*   `scripts/`: Utility scripts for build and maintenance.
+
+# Project Rules Agent
+
+- The user explicitly wants real, working code only. I must never add mocks, placeholders, false-passed success code, or any non-functional code. All solutions should be directly applicable to a live editor and pass all relevant tests genuinely.
+- The user explicitly requires real, working code only. I must never add mocks, placeholders, false-passed success codes, or any non-functional code. All solutions must be directly applicable to a live editor and pass all relevant tests genuinely.
+- Always read full file content.
+- Engine path: X:\Unreal_Engine\UE_5.0\Engine
+- Engine path: X:\Unreal_Engine\UE_5.6\Engine
+- Engine path: X:\Unreal_Engine\UE_5.7\Engine
+- Before editing codes in plugin make sure to check before in engine's code so that all code are correct.

package/README.md

@@ -3,208 +3,267 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![NPM Package](https://img.shields.io/npm/v/unreal-engine-mcp-server)](https://www.npmjs.com/package/unreal-engine-mcp-server)
 [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-TypeScript-blue)](https://github.com/modelcontextprotocol/sdk)
-[![Unreal Engine](https://img.shields.io/badge/Unreal%20Engine-5.0--5.6-orange)](https://www.unrealengine.com/)
+[![Unreal Engine](https://img.shields.io/badge/Unreal%20Engine-5.0--5.7-orange)](https://www.unrealengine.com/)
 [![MCP Registry](https://img.shields.io/badge/MCP%20Registry-Published-green)](https://registry.modelcontextprotocol.io/)
 
-A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal Engine via Remote Control API. Built with TypeScript and designed for game development automation.
+A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal Engine through a native C++ Automation Bridge plugin. Built with TypeScript, C++, and Rust (WebAssembly).
+
+---
+
+## Table of Contents
+
+- [Features](#features)
+- [Getting Started](#getting-started)
+- [Configuration](#configuration)
+- [Available Tools](#available-tools)
+- [WebAssembly Acceleration](#webassembly-acceleration)
+- [GraphQL API](#graphql-api)
+- [Docker](#docker)
+- [Documentation](#documentation)
+- [Development](#development)
+- [Contributing](#contributing)
+
+---
 
 ## Features
 
-### Core Capabilities
-- **Asset Management** - Browse, import, and create materials
-- **Actor Control** - Spawn, delete, and manipulate actors with physics
-- **Editor Control** - PIE sessions, camera, and viewport management
-- **Level Management** - Load/save levels, lighting, and environment building
-- **Animation & Physics** - Blueprints, state machines, ragdolls, constraints
-- **Visual Effects** - Niagara particles, GPU simulations, procedural effects
-- **Sequencer** - Cinematics, camera animations, and timeline control
-- **Console Commands** - Safe execution with dangerous command filtering
+| Category | Capabilities |
+|----------|-------------|
+| **Asset Management** | Browse, import, duplicate, rename, delete assets; create materials |
+| **Actor Control** | Spawn, delete, transform, physics, tags, components |
+| **Editor Control** | PIE sessions, camera, viewport, screenshots, bookmarks |
+| **Level Management** | Load/save levels, streaming, World Partition, data layers |
+| **Animation & Physics** | Animation BPs, state machines, ragdolls, vehicles, constraints |
+| **Visual Effects** | Niagara particles, GPU simulations, procedural effects, debug shapes |
+| **Sequencer** | Cinematics, timeline control, camera animations, keyframes |
+| **Graph Editing** | Blueprint, Niagara, Material, and Behavior Tree graph manipulation |
+| **Audio** | Sound cues, audio components, sound mixes, ambient sounds |
+| **System** | Console commands, UBT, tests, logs, project settings, CVars |
 
-## Quick Start
+### Architecture
 
-### Prerequisites
-- Node.js 18+
-- Unreal Engine 5.0-5.6
-- Required UE Plugins (enable via **Edit ▸ Plugins**):
-  - **Remote Control API** – core Remote Control HTTP/WS endpoints
-  - **Remote Control Web Interface** – enables WebSocket bridge used by this server
-  - **Python Editor Script Plugin** – exposes Python runtime for automation
-  - **Editor Scripting Utilities** – unlocks Editor Actor/Asset subsystems used throughout the tools
-  - **Sequencer** *(built-in)* – keep enabled for cinematic tools
-  - **Level Sequence Editor** – required for `manage_sequence` operations
+- **Native C++ Automation** — All operations route through the MCP Automation Bridge plugin
+- **Graceful Degradation** — Server starts even without an active Unreal connection
+- **On-Demand Connection** — Retries automation handshakes with exponential backoff
+- **Command Safety** — Blocks dangerous console commands
+- **Asset Caching** — 10-second TTL for improved performance
 
-> 💡 After toggling any plugin, restart the editor to finalize activation. Keep `Editor Scripting Utilities` and `Python Editor Script Plugin` enabled prior to connecting, otherwise many subsystem-based tools (actor spawning, audio, foliage, UI widgets) will refuse to run for safety.
+---
 
-### Plugin feature map
+## Getting Started
 
-| Plugin | Location | Used By | Notes |
-|--------|----------|---------|-------|
-| Remote Control API | Developer Tools ▸ Remote Control | All tools | Provides HTTP/WS endpoints consumed by the MCP bridge |
-| Remote Control Web Interface | Developer Tools ▸ Remote Control | All tools | Enables persistent WebSocket session |
-| Python Editor Script Plugin | Scripting | Landscapes, lighting, audio, physics, sequences, UI | Required for every Python execution path |
-| Editor Scripting Utilities | Scripting | Actors, foliage, assets, landscapes, UI | Supplies Editor Actor/Asset subsystems in UE5.6 |
-| Sequencer | Built-in | Sequencer tools | Ensure not disabled in project settings |
-| Level Sequence Editor | Animation | Sequencer tools | Activate before calling `manage_sequence` operations |
+### Prerequisites
 
-### Installation
+- **Node.js** 18+
+- **Unreal Engine** 5.0–5.7
 
-#### Option 1: NPM Package (Recommended)
+### Step 1: Install MCP Server
 
+**Option A: NPX (Recommended)**
 ```bash
-# Install globally
-npm install -g unreal-engine-mcp-server
-
-# Or install locally in your project
-npm install unreal-engine-mcp-server
+npx unreal-engine-mcp-server
 ```
 
-#### Option 2: Clone and Build
-
+**Option B: Clone & Build**
 ```bash
-# Clone the repository
 git clone https://github.com/ChiR24/Unreal_mcp.git
 cd Unreal_mcp
-
-# Install dependencies and build
 npm install
 npm run build
-
-# Run directly
 node dist/cli.js
 ```
 
-### Unreal Engine Configuration
+### Step 2: Install Unreal Plugin
 
-Add to your project's `Config/DefaultEngine.ini`:
+The MCP Automation Bridge plugin is included at `Unreal_mcp/plugins/McpAutomationBridge`.
 
-```ini
-[/Script/PythonScriptPlugin.PythonScriptPluginSettings]
-bRemoteExecution=True
-bAllowRemotePythonExecution=True
-
-[/Script/RemoteControl.RemoteControlSettings]
-bAllowRemoteExecutionOfConsoleCommands=True
-bEnableRemoteExecution=True
-bAllowPythonExecution=True
+**Method 1: Copy Folder**
+```
+Copy:  Unreal_mcp/plugins/McpAutomationBridge/
+To:    YourUnrealProject/Plugins/McpAutomationBridge/
 ```
+Regenerate project files after copying.
+
+**Method 2: Add in Editor**
+1. Open Unreal Editor → **Edit → Plugins**
+2. Click **"Add"** → Browse to `Unreal_mcp/plugins/`
+3. Select the `McpAutomationBridge` folder
 
-Then enable Python execution in: Edit > Project Settings > Plugins > Remote Control
+**Video Guide:**
 
-## MCP Client Configuration
+https://github.com/user-attachments/assets/d8b86ebc-4364-48c9-9781-de854bf3ef7d
 
-### Claude Desktop / Cursor
+### Step 3: Enable Required Plugins
 
-#### For NPM Installation (Local)
+Enable via **Edit → Plugins**, then restart the editor:
 
+| Plugin | Required For |
+|--------|--------------|
+| **MCP Automation Bridge** | All automation operations |
+| **Editor Scripting Utilities** | Asset/Actor subsystem operations |
+| **Sequencer** | Sequencer tools |
+| **Level Sequence Editor** | `manage_sequence` operations |
+| **Control Rig** | `animation_physics` operations |
+| **Subobject Data Interface** | Blueprint components (UE 5.7+) |
+
+### Step 4: Configure MCP Client
+
+Add to your Claude Desktop / Cursor config file:
+
+**Using Clone/Build:**
 ```json
 {
   "mcpServers": {
     "unreal-engine": {
-      "command": "npx",
-      "args": ["unreal-engine-mcp-server"],
+      "command": "node",
+      "args": ["path/to/Unreal_mcp/dist/cli.js"],
       "env": {
-        "UE_HOST": "127.0.0.1",
-        "UE_RC_HTTP_PORT": "30010",
-        "UE_RC_WS_PORT": "30020",
-        "UE_PROJECT_PATH": "C:/Users/YourName/Documents/Unreal Projects/YourProject"
+        "UE_PROJECT_PATH": "C:/Path/To/YourProject",
+        "MCP_AUTOMATION_PORT": "8091"
       }
     }
   }
 }
 ```
 
-#### For Clone/Build Installation
-
+**Using NPX:**
 ```json
 {
   "mcpServers": {
     "unreal-engine": {
-      "command": "node",
-      "args": ["path/to/Unreal_mcp/dist/cli.js"],
+      "command": "npx",
+      "args": ["unreal-engine-mcp-server"],
       "env": {
-        "UE_HOST": "127.0.0.1",
-        "UE_RC_HTTP_PORT": "30010",
-        "UE_RC_WS_PORT": "30020",
-        "UE_PROJECT_PATH": "C:/Users/YourName/Documents/Unreal Projects/YourProject"
+        "UE_PROJECT_PATH": "C:/Path/To/YourProject"
       }
     }
   }
 }
 ```
 
-## Available Tools (13)
-
-| Tool | Description |
-|------|-------------|
-| `manage_asset` | List, create materials, import assets |
-| `control_actor` | Spawn, delete actors, apply physics |
-| `control_editor` | PIE control, camera, view modes |
-| `manage_level` | Load/save levels, lighting |
-| `animation_physics` | Animation blueprints, ragdolls |
-| `create_effect` | Particles, Niagara, debug shapes |
-| `manage_blueprint` | Create blueprints, add components |
-| `build_environment` | Landscapes, terrain, foliage |
-| `system_control` | Profiling, quality, UI, screenshots, Output Log reading |
-| `console_command` | Direct console command execution |
-| `manage_rc` | Remote Control presets |
-| `manage_sequence` | Sequencer/cinematics |
-| `inspect` | Object introspection |
-
-## Key Features
-
-- **Graceful Degradation** - Server starts even without UE connection
-- **Auto-Reconnection** - Attempts reconnection every 10 seconds
-- **Connection Timeout** - 5-second timeout with configurable retries
-- **Non-Intrusive Health Checks** - Uses echo commands every 30 seconds
-- **Command Safety** - Blocks dangerous console commands
-- **Input Flexibility** - Vectors/rotators accept object or array format
-- **Asset Caching** - 10-second TTL for improved performance
-
-## Supported Asset Types
-
-Blueprints, Materials, Textures, Static/Skeletal Meshes, Levels, Sounds, Particles, Niagara Systems
-
-## Example Console Commands
-
-- **Statistics**: `stat fps`, `stat gpu`, `stat memory`
-- **View Modes**: `viewmode wireframe`, `viewmode unlit`
-- **Gameplay**: `slomo 0.5`, `god`, `fly`
-- **Rendering**: `r.screenpercentage 50`, `r.vsync 0`
+---
 
 ## Configuration
 
 ### Environment Variables
 
 ```env
-UE_HOST=127.0.0.1              # Unreal Engine host
-UE_RC_HTTP_PORT=30010          # Remote Control HTTP port
-UE_RC_WS_PORT=30020            # Remote Control WebSocket port
-UE_PROJECT_PATH="C:/Users/YourName/Documents/Unreal Projects/YourProject"  # Absolute path to your .uproject file
-LOG_LEVEL=info                 # debug | info | warn | error
+# Required
+UE_PROJECT_PATH="C:/Path/To/YourProject"
+
+# Automation Bridge
+MCP_AUTOMATION_HOST=127.0.0.1
+MCP_AUTOMATION_PORT=8091
+
+# Logging
+LOG_LEVEL=info  # debug | info | warn | error
+
+# Optional
+WASM_ENABLED=true
+MCP_AUTOMATION_REQUEST_TIMEOUT_MS=120000
+ASSET_LIST_TTL_MS=10000
 ```
 
-### Docker
+---
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `manage_asset` | Assets, Materials, Render Targets, Behavior Trees |
+| `control_actor` | Spawn, delete, transform, physics, tags |
+| `control_editor` | PIE, Camera, viewport, screenshots |
+| `manage_level` | Load/Save, World Partition, streaming |
+| `manage_lighting` | Spawn lights, GI, shadows, build lighting |
+| `manage_performance` | Profiling, optimization, scalability |
+| `animation_physics` | Animation BPs, Vehicles, Ragdolls |
+| `manage_effect` | Niagara, Particles, Debug Shapes |
+| `manage_blueprint` | Create, SCS, Graph Editing |
+| `manage_blueprint_graph` | Direct Blueprint Graph Manipulation |
+| `build_environment` | Landscape, Foliage, Procedural |
+| `system_control` | UBT, Tests, Logs, Project Settings, CVars |
+| `manage_sequence` | Sequencer / Cinematics |
+| `inspect` | Object Introspection |
+| `manage_audio` | Audio Assets & Components |
+| `manage_behavior_tree` | Behavior Tree Graph Editing |
+| `manage_input` | Enhanced Input Actions & Contexts |
+
+### Supported Asset Types
+
+Blueprints • Materials • Textures • Static Meshes • Skeletal Meshes • Levels • Sounds • Particles • Niagara Systems • Behavior Trees
+
+---
+
+## WebAssembly Acceleration
+
+Optional WASM acceleration for computationally intensive operations. **Enabled by default** when available, falls back to TypeScript automatically.
+
+| Operation | Speedup |
+|-----------|---------|
+| JSON parsing | 5–8x |
+| Transform calculations | 5–10x |
+| Vector/matrix math | 5x |
+| Dependency resolution | 3–5x |
+
+### Building WASM (Optional)
 
 ```bash
-docker build -t unreal-mcp .
-docker run -it --rm unreal-mcp
+cargo install wasm-pack  # Once per machine
+npm run build            # Builds TS + WASM
+```
+
+To disable: `WASM_ENABLED=false`
+
+---
+
+## GraphQL API
+
+Optional GraphQL endpoint for complex queries. **Disabled by default.**
+
+```env
+GRAPHQL_ENABLED=true
+GRAPHQL_PORT=4000
 ```
 
-Pull from Docker Hub
+See [GraphQL API Documentation](docs/GraphQL-API.md).
+
+---
+
+## Docker
 
 ```bash
-docker pull mcp/server/unreal-engine-mcp-server:latest
-docker run --rm -it mcp/server/unreal-engine-mcp-server:latest
+docker build -t unreal-mcp .
+docker run -it --rm -e UE_PROJECT_PATH=/project unreal-mcp
 ```
 
+---
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [Handler Mappings](docs/handler-mapping.md) | TypeScript to C++ routing |
+| [GraphQL API](docs/GraphQL-API.md) | Query and mutation reference |
+| [WebAssembly Integration](docs/WebAssembly-Integration.md) | WASM performance guide |
+| [Plugin Extension](docs/editor-plugin-extension.md) | C++ plugin architecture |
+| [Testing Guide](docs/testing-guide.md) | How to run and write tests |
+| [Migration Guide v0.5.0](docs/Migration-Guide-v0.5.0.md) | Upgrade to v0.5.0 |
+| [Roadmap](docs/Roadmap.md) | Development phases |
+| [Automation Progress](docs/native-automation-progress.md) | Implementation status |
+
+---
+
 ## Development
 
 ```bash
-npm run build          # Build TypeScript
-npm run lint           # Run ESLint
-npm run lint:fix       # Fix linting issues
+npm run build       # Build TypeScript + WASM
+npm run lint        # Run ESLint
+npm run test:unit   # Run unit tests
+npm run test:all    # Run all tests
 ```
 
+---
+
 ## Contributing
 
 Contributions welcome! Please:
@@ -212,6 +271,8 @@ Contributions welcome! Please:
 - Keep PRs focused and small
 - Follow existing code style
 
+---
+
 ## License
 
-MIT - See [LICENSE](LICENSE) file
+MIT — See [LICENSE](LICENSE)

package/claude_desktop_config_example.json

@@ -2,13 +2,14 @@
   "mcpServers": {
     "unreal-engine": {
       "command": "node",
-      "args": ["PathToMCP\\UnrealMCP\\unreal-engine-mcp-server\\dist\\cli.js"],
+      "args": [
+        "PathToMCP\\UnrealMCP\\unreal-engine-mcp-server\\dist\\cli.js"
+      ],
       "env": {
-        "UE_HOST": "127.0.0.1",
-        "UE_RC_WS_PORT": "30020",
-        "UE_RC_HTTP_PORT": "30010",
-        "UE_PROJECT_PATH": "C:/Users/YourName/Documents/Unreal Projects/YourProject"
+        "UE_PROJECT_PATH": "C:/Users/YourName/Documents/Unreal Projects/YourProject",
+        "MCP_AUTOMATION_HOST": "127.0.0.1",
+        "MCP_AUTOMATION_PORT": "8091"
       }
     }
   }
-}
+}