Skip to content
Back to search

unreal-mcp

MCP server for Unreal Engine that uses Unreal Python Remote Execution

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/runreal--unreal-mcp/badge.svg)](/listings/runreal--unreal-mcp)

HTML

<a href="/listings/runreal--unreal-mcp"><img src="/api/listings/runreal--unreal-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

πŸ“‹ Requirements

- πŸ”§ Unreal Engine 5.4+ (verified, may work with earlier versions) - 🟒 Node.js with npx - πŸ€– MCP Client (Claude, Cursor, etc.)

1. Setting up your Editor: - Open your Unreal Engine project - Go to `Edit` -> `Plugins` - Search for "Python Editor Script Plugin" and enable it - Restart the editor if prompted - Go to `Edit` -> `Project Settings` - Search for "Python" and enable the "Enable Remote Execution" option

2. Set up your Client: - Edit your Claude (or Cursor) config

{
  "mcpServers": {
    "unreal": {
      "command": "npx",
      "args": [
        "-y",
        "@runreal/unreal-mcp"
      ]
    }
  }
}

πŸ”§ Troubleshooting

If you get an error similar to `MCP Unreal: Unexpected token 'C', Connection...` it means that the mcp-server was not able to connect to the Unreal Editor.

- Make sure that the Python Editor Script Plugin is enabled and that the Remote Execution option is checked in your project settings. - Try also changing your bind address from `127.0.0.1` to `0.0.0.0` but note that this will allow connections from your local network. - Restart your Unreal Editor fully. - Fully close/open your client (Claude, Cursor, etc.) to ensure it reconnects to the MCP server. (`File -> Exit` on windows). - Check your running processes and kill any zombie unreal-mcp Node.js processes.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md Β· README Β· 111 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # unreal-mcp
  2. > MCP server for Unreal Engine that uses Unreal Python Remote Execution
  3. ![hero](https://github.com/runreal/unreal-mcp/raw/refs/heads/main/hero.png)
  4. ![gif](https://github.com/runreal/unreal-mcp/raw/refs/heads/main/mcp.gif)
  5. <p align="center">
  6. <a href="https://x.com/runreal_dev">Twitter</a>
  7. Β·
  8. <a href="https://discord.gg/6ZhWVU5W47">Discord</a>
  9. </p>
  10. <div align="center">
  11. <a href="LICENSE"><img alt="license" src="https://img.shields.io/badge/LICENSE-MIT-GREEN?style=flat-square"></a>
  12. </div>
  13. ## ⚑ Differences
  14. This server does not require installing a new UE plugin as it uses the built-in Python remote execution protocol.
  15. Adding new tools/features is much faster to develop since it does not require any C++ code.
  16. It can support the full [Unreal Engine Python API](https://dev.epicgames.com/documentation/en-us/unreal-engine/python-api)
  17. ## ⚠️ Note
  18. - This is not an official Unreal Engine project.
  19. - Your AI agents or tools will have full access to your Editor.
  20. - Review any changes your Client suggests before you approve them.
  21. ## πŸ“¦ Installation
  22. #### πŸ“‹ Requirements
  23. - πŸ”§ Unreal Engine 5.4+ (verified, may work with earlier versions)
  24. - 🟒 Node.js with npx
  25. - πŸ€– MCP Client (Claude, Cursor, etc.)
  26. 1. Setting up your Editor:
  27. - Open your Unreal Engine project
  28. - Go to `Edit` -> `Plugins`
  29. - Search for "Python Editor Script Plugin" and enable it
  30. - Restart the editor if prompted
  31. - Go to `Edit` -> `Project Settings`
  32. - Search for "Python" and enable the "Enable Remote Execution" option
  33. ![enable plugin](https://github.com/runreal/unreal-mcp/raw/refs/heads/main/img1.png)
  34. ![enable remote execution](https://github.com/runreal/unreal-mcp/raw/refs/heads/main/img2.png)
  35. 2. Set up your Client:
  36. - Edit your Claude (or Cursor) config
  37. ```json
  38. {
  39. "mcpServers": {
  40. "unreal": {
  41. "command": "npx",
  42. "args": [
  43. "-y",
  44. "@runreal/unreal-mcp"
  45. ]
  46. }
  47. }
  48. }
  49. ```
  50. ### πŸ”§ Troubleshooting
  51. If you get an error similar to `MCP Unreal: Unexpected token 'C', Connection...` it means that the mcp-server was not able to connect to the Unreal Editor.
  52. - Make sure that the Python Editor Script Plugin is enabled and that the Remote Execution option is checked in your project settings.
  53. - Try also changing your bind address from `127.0.0.1` to `0.0.0.0` but note that this will allow connections from your local network.
  54. - Restart your Unreal Editor fully.
  55. - Fully close/open your client (Claude, Cursor, etc.) to ensure it reconnects to the MCP server. (`File -> Exit` on windows).
  56. - Check your running processes and kill any zombie unreal-mcp Node.js processes.
  57. ## πŸ› οΈ Available Tools
  58. | Tool | Description |
  59. |------|-------------|
  60. | `set_unreal_engine_path` | Set the Unreal Engine path |
  61. | `set_unreal_project_path` | Set the Project path |
  62. | `get_unreal_engine_path` | Get the current Unreal Engine path |
  63. | `get_unreal_project_path` | Get the current Unreal Project path |
  64. | `editor_run_python` | Execute any python within the Unreal Editor |
  65. | `editor_list_assets` | List all Unreal assets |
  66. | `editor_export_asset` | Export an Unreal asset to text |
  67. | `editor_get_asset_info` | Get information about an asset, including LOD levels for StaticMesh and SkeletalMesh assets |
  68. | `editor_get_asset_references` | Get references for an asset |
  69. | `editor_console_command` | Run a console command in Unreal |
  70. | `editor_project_info` | Get detailed information about the current project |
  71. | `editor_get_map_info` | Get detailed information about the current map/level |
  72. | `editor_search_assets` | Search for assets by name or path with optional class filter |
  73. | `editor_get_world_outliner` | Get all actors in the current world with their properties |
  74. | `editor_validate_assets` | Validate assets in the project to check for errors |
  75. | `editor_create_object` | Create a new object/actor in the world |
  76. | `editor_update_object` | Update an existing object/actor in the world |
  77. | `editor_delete_object` | Delete an object/actor from the world |
  78. | `editor_take_screenshot` | Take a screenshot of the Unreal Editor |
  79. | `editor_move_camera` | Move the viewport camera to a specific location and rotation for positioning screenshots |
  80. ## 🀝 Contributing
  81. Please feel free to open issues or pull requests. Contributions are welcome, especially new tools/commands.
  82. <a href="https://glama.ai/mcp/servers/@runreal/unreal-mcp">
  83. <img width="380" height="200" src="https://glama.ai/mcp/servers/@runreal/unreal-mcp/badge" />
  84. </a>
  85. ### License MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.