Model Context Protocol for Unreal Engine

Name: Model Context Protocol for Unreal Engine
Author: chongdashu

@chongdashu

Model Context Protocol for Unreal Engine について

Enable AI assistant clients like Cursor, Windsurf and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP).

#unreal-engine-5 #mcp-server #modelcontextprotocol

基本情報

カテゴリ

AI とエージェント

ランタイム

c++

トランスポート

stdio

公開者

chongdashu

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "unrealMCP": {
      "command": "uv",
      "args": [
        "--directory",
        "<path/to/the/folder/PYTHON>",
        "run",
        "unreal_mcp_server.py"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is Model Context Protocol for Unreal Engine?

An experimental integration that enables AI assistant clients like Cursor, Windsurf, and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP). It consists of a UE plugin (C++ TCP server) and a Python MCP server that expose tools for actor, Blueprint, and editor operations.

How to use Model Context Protocol for Unreal Engine?

You use the provided Unreal sample project or copy the plugin into your own project, enable the plugin, and build it. Then set up the Python server (requires Python 3.12+), and configure your MCP client (e.g., Claude Desktop, Cursor, Windsurf) with a JSON configuration pointing to unreal_mcp_server.py. The server communicates with the plugin over TCP (port 55557).

Key features of Model Context Protocol for Unreal Engine

Create and manipulate actors (cubes, lights, cameras, etc.)
Set and query actor transforms and properties
Create Blueprint classes and add components
Compile Blueprints and spawn Blueprint actors
Add nodes to Blueprint graphs and connect them
Control viewport focus and camera

Use cases of Model Context Protocol for Unreal Engine

Automate actor level layout using natural language
Rapidly prototype Blueprint logic through chat commands
Generate and position lighting in a scene via AI assistant
Create input mappings for player controls without manual setup

FAQ from Model Context Protocol for Unreal Engine

What are the system requirements?

Unreal Engine 5.5+ and Python 3.12+ are required. An MCP-compatible client (Claude Desktop, Cursor, or Windsurf) is also needed.

How do I configure the MCP client?

Add a JSON entry under mcpServers in your client’s configuration file, specifying uv as the command with arguments pointing to the Python directory and unreal_mcp_server.py. The file location varies: Claude Desktop uses ~/.config/claude-desktop/mcp.json, Cursor uses .cursor/mcp.json in the project root, and Windsurf uses ~/.config/windsurf/mcp.json.

Is this production‑ready?

No, the project is currently experimental. Features may be incomplete or unstable, breaking changes can occur without notice, and production use is not recommended.

What transport does the Python server use?

The Python server uses TCP sockets (port 55557) to communicate with the Unreal Engine C++ plugin, and implements the Model Context Protocol via the FastMCP library.