ue5

This MCP server exposes a Python-based interface that wraps the Unreal Engine 5 (UE5) Blueprint APIs via a custom UE plugin. It runs in streamable HTTP mode using FastMCP to accept and process requests to manage Blueprints, functions, variables, components, and visual scripting graphs. The server enables an AI agent to create, modify, and query Blueprint assets by issuing API calls that map to UE5 Editor Utility C++ API endpoints exposed by the plugin. Typical workflows include creating or compiling Blueprints, inspecting or editing variables and functions, adding or connecting nodes in the visual scripting graph, and managing components and their properties. Tools are organized around Blueprint Management, Blueprint Functions, Blueprint Visual Scripting, Blueprint Variables, and Blueprint Components, providing programmatic access to common UE5 Blueprint tasks via HTTP.

To use the server, run it with a configured UE5 REST API endpoint. The environment variables you’ll typically configure are PORT for the server port and UE5_REST_API_URL for the UE5 plugin/API base URL. Once running, you can issue HTTP requests (or use an agent) to perform operations such as creating a Blueprint, adding a function, or wiring up a node in a Blueprint graph. The server is designed to be integrated into larger AI-assisted pipelines where LLMs generate the requested Blueprint modifications and the MCP server executes them against the UE5 project.

Prerequisites:

• Unreal Engine 5 project with the UE5_MCP plugin installed and enabled
• Python 3.8+ installed
• Access to the project’s Plugins/ directory

Installation steps:

1. Open a terminal and navigate to your UE5 project Plugins directory:

   cd <YourUEProject>/Plugins

2. Clone the MCP server repository:

   git clone https://github.com/cutehusky/ue5-mcp.git

3. (Optional) Create a Python virtual environment and activate it:

   python -m venv venv source venv/bin/activate # on Windows use: venv\Scripts\activate

4. Install Python dependencies for the MCP server:

   cd Python/MCP pip install mcp httpx python-dotenv

5. Ensure the UE5_MCP plugin is enabled in UE5 and that the UE5 REST API is accessible at the URL you will configure in the environment variables.

6. Prepare environment variables for running the MCP server (see mcp_config for examples).

7. Run the MCP server:

   python mcp_server.py

Tips and notes:

• Ensure the UE5 REST API endpoint (UE5_REST_API_URL) is reachable from where you run the MCP server and that any required authentication or network access is configured.
• The server uses a streamable HTTP mode via FastMCP; consider configuring the port (PORT) to avoid conflicts with other services.
• If you modify the plugin or endpoints, you may need to restart the MCP server to pick up changes.
• Use descriptive environment variable values or placeholders to document required inputs for your deployment environment.
• Common issues include network/firewall blocks between the MCP server and UE5 REST API, or missing Python dependencies; ensure the plugin is loaded in UE5 and the Python dependencies are installed.
• For debugging, check the MCP server logs for endpoint responses and any API failure messages to map them back to UE5 API calls.