MCP.so
登录

Model Context Protocol for Unreal Engine

@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).

基本信息

分类

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.

Where can I ask questions or report issues?

You can reach the author on X/Twitter: @chongdashu.

评论

AI 与智能体 分类下的更多 MCP 服务器