UnrealClaude

UnrealClaude exposes a Model Context Protocol (MCP) server that bridges Claude Code capabilities with Unreal Engine 5.7 editor context. The MCP server runs locally (default on port 3000) and provides 20+ tools across categories like Actor manipulation, Level Management, Blueprint editing, Animation Blueprint operations, asset queries, and script execution. This enables Claude to spawn, inspect, modify, and manage UE assets and editor state programmatically, while preserving project context and editor session history. To use it, start the MCP bridge (the Node.js server in the plugin's resources) and point Claude or any MCP client at localhost:3000 to access the toolset. The tools are designed to work inside the editor session, pulling project context (modules, plugins, assets) and enabling live interactions with the running Unreal Engine instance.

Prerequisites:

• Unreal Engine 5.7 installed and a compatible project
• Node.js and npm installed on your system

Step 1: Clone the UnrealClaude repository

• git clone https://github.com/Natfii/UnrealClaude.git

Step 2: Install MCP bridge dependencies

• Navigate to the MCP bridge directory: cd UnrealClaude/Resources/mcp-bridge
• Install npm dependencies: npm install

Step 3: Build/prepare the plugin for your platform (if required by your setup)

• Follow the repository's guide to build the UnrealClaude plugin for your OS

Step 4: Run the MCP bridge server

• Ensure your Unreal Editor is running and the plugin is loaded
• Start the MCP server (from the plugin's directory): node server.js

Step 5: Verify the MCP server is listening

• You should see a message indicating the MCP server is listening on port 3000 (or the configured port). You can test with a basic MCP client or curl to http://localhost:3000/health

Note: If your environment requires a different host/port, adjust the MCP_PORT and MCP_HOST environment variables accordingly when launching the server.

Tips and common issues:

• Port conflicts: If port 3000 is in use, reconfigure the MCP_PORT env var to an available port and update your MCP client accordingly.
• Authentication: Claude Code CLI integration uses its own authentication flow; ensure Claude Code CLI is installed and authenticated if you plan to use Claude with the MCP tools.
• Editor context: The MCP server relies on the running Unreal Editor instance. Ensure the UnrealClaude plugin is loaded and the editor has the Claude Assistant/tools panel accessible.
• Plugin build: Some tools may require building the UnrealClaude plugin for your engine/OS. Use the repository's provided build steps per platform.
• Network access: Since the MCP server runs locally, ensure there are no firewall rules blocking localhost connections to the configured port.
• Tool compatibility: While 20+ tools are exposed, some operations may behave differently depending on editor state or asset types. Always save work before running scripted operations.