Skip to main content

unreal-mcp-server

unreal-mcp-server is a Python-based server that implements the Model Context Protocol (MCP) for Unreal Engine. It enables smooth communication between MCP clients (e.g., Claude, Cursor, Windsurf) and the Unreal Editor, and is intended to be used together with the Unreal-MCPython Plugin.

🎯 Why Choose Unreal-MCPython?

  • 🧠 Unreal AI integration - Direct Claude AI assistance in Unreal Engine
  • 🔗 Native MCP protocol support - Seamless communication between AI and UE
  • 🎮 Intelligent game development - AI-powered asset management and scene manipulation
  • ⚡ Smart automation - Context-aware blueprint scripting with AI guidance
  • 🎨 Technical artist focused - AI assistance for complex production pipelines

Key Features

  • MCP server for communication with Unreal Engine
  • Built-in routers for various operations (e.g., Actor, Asset, Editor, etc)
  • Supports Python 3.11 and later

Installation

Clone the repository:

git clone https://github.com/your-org/unreal-mcp-server.git
cd unreal-mcp-server

Running the Server

You can start the MCP server with the following command:

uv --directory absolute/path/to/unreal-mcp-server run src/unreal_mcp/main.py

Example Configuration (Using Claude, VSCode, Cursor)

The following is an example configuration for launching the MCP server from Claude, VSCode, or Cursor:

{
    "mcpServers": {
        "unreal-mcpython": {
            "command": "uv",
            "args": [
                "--directory",
                "/absolute/path/to/unreal-mcp-server",  // e.g., D:/GitHub/unreal-mcp-server
                "run",
                "src/unreal_mcp/main.py"
            ]
        }
    }
}

This configuration approach works similarly across editors like VSCode and Cursor.

License

This project is licensed under the Apache-2.0 License. See the LICENSE file for details.

Metadata

Release files for iflow-mcp_genorca-unrealmcp 1.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for iflow-mcp_genorca-unrealmcp 1.0.2
File Size Uploaded
iflow_mcp_genorca_unrealmcp-1.0.2.tar.gz 17.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for iflow-mcp_genorca-unrealmcp 1.0.2
File Interpreter ABI Platform
iflow_mcp_genorca_unrealmcp-1.0.2-py3-none-any.whl Python 3 none any Details

Total release size: 39.6 kB

Release files / iflow_mcp_genorca_unrealmcp-1.0.2.tar.gz

Download URL iflow_mcp_genorca_unrealmcp-1.0.2.tar.gz
Size 17.6 kB
Tags Source
SHA-256 checksum
How to use checksums
33373791056507eb522713f58ecffe1c3a136b6e0295abdacdcdb13d1248ff97
BLAKE2b-256 checksum
How to use checksums
50720af257ad72da89fe251a1fd3e8cea0855a2da76e99a736b972686fb7d3bc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / iflow_mcp_genorca_unrealmcp-1.0.2-py3-none-any.whl

Download URL iflow_mcp_genorca_unrealmcp-1.0.2-py3-none-any.whl
Size 22.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5348089dadeaec8c2fa4c55afa5402d0b39d6f3b599baf42f24a9b93185f8bbf
BLAKE2b-256 checksum
How to use checksums
5d189d18859a0fa9f8dd6599618ac3a9002a7263afdd4292418f34f2966afe66
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

1.0.2 This release

2 release files

1.0.1

1 release file

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page