ultimate-unreal-engine-mcp 0.1.15 → 0.1.17

package/README.md

@@ -1,12 +1,12 @@
 # Ultimate Unreal Engine MCP
 
-**129 tools. 26 domains. Full read/write access to Unreal Engine 5.7 — including live editor APIs, Blueprint graphs, and viewport screenshots.**
+**132 tools. 26 domains. Full read/write access to Unreal Engine 5.7 — including live editor APIs, Blueprint graphs, and viewport screenshots.**
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![Node 22+](https://img.shields.io/badge/Node.js-22%2B-brightgreen.svg)](https://nodejs.org/)
 [![UE 5.7](https://img.shields.io/badge/Unreal%20Engine-5.7-orange.svg)](https://www.unrealengine.com/)
 [![Tests](https://img.shields.io/badge/tests-1021%20passing-success.svg)](#development)
-[![Tools](https://img.shields.io/badge/tools-129-informational.svg)](#tool-catalog)
+[![Tools](https://img.shields.io/badge/tools-132-informational.svg)](#tool-catalog)
 
 MCP (Model Context Protocol) is a standard that lets AI assistants call tools on external systems — this server exposes Unreal Engine as those tools.
 
@@ -296,14 +296,17 @@ graph TD
 </details>
 
 <details>
-<summary><strong>Editor</strong> — 7 tools</summary>
+<summary><strong>Editor</strong> — 10 tools</summary>
 
 | Tool | Description |
 |------|-------------|
 | `ue_list_actors` | List actors in the current level with transforms and class info |
-| `ue_spawn_actor` | Spawn an actor by class into the current level |
+| `ue_spawn_actor` | Spawn an actor by class with optional label |
 | `ue_transform_actor` | Move, rotate, scale, or set properties on an actor |
 | `ue_delete_actor` | Delete an actor from the current level |
+| `ue_set_actor_property` | Set any UPROPERTY on an actor or component by label (bool, int, float, string, name, actor ref, asset ref) |
+| `ue_create_data_asset` | Create a UPrimaryDataAsset with reflection-set properties |
+| `ue_create_curve` | Create a UCurveFloat asset with keyframes |
 | `ue_query_assets` | Query the asset registry — search by class, path, or name |
 | `ue_trace_references` | Trace all assets that reference or are referenced by an asset |
 | `ue_read_level_layout` | Read the current level's actor graph and spatial layout |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ultimate-unreal-engine-mcp",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "MCP server giving AI assistants full access to Unreal Engine 5.7 projects",
   "type": "module",
   "engines": {

package/unreal-plugin/MCPBridge/Source/MCPBridgeEditor/Private/MCPViewportCommands.cpp

@@ -24,6 +24,8 @@
 #include "Editor.h"
 #include "EditorViewportClient.h"
 #include "LevelEditorViewport.h"
+#include "LevelEditor.h"
+#include "SLevelViewport.h"
 #include "UnrealClient.h"
 #include "HighResScreenshot.h"
 #include "Misc/Paths.h"
@@ -74,10 +76,10 @@ static FString BuildViewportErrorResponse(const FString& CorrId, const FString&
 }
 
 /**
- * Returns the first visible level editor viewport client, or nullptr if none is open.
- * A static_cast is safe here because MCPBridgeEditor only runs inside the editor and
- * GetAllViewportClients() in the level editor context returns FLevelEditorViewportClient
- * instances.
+ * Returns the first level editor viewport client.
+ * Uses FLevelEditorModule::GetFirstActiveLevelViewport() which reliably
+ * returns the docked viewport even when it doesn't have focus.
+ * Falls back to GEditor->GetAllViewportClients() scan if the module approach fails.
  */
 static FLevelEditorViewportClient* GetActiveViewportClient()
 {
@@ -86,14 +88,24 @@ static FLevelEditorViewportClient* GetActiveViewportClient()
 		return nullptr;
 	}
 
-	for (FEditorViewportClient* VC : GEditor->GetAllViewportClients())
+	// Primary path: use the LevelEditor module API (works for docked viewports).
+	if (FModuleManager::Get().IsModuleLoaded(TEXT("LevelEditor")))
 	{
-		if (!VC)
+		FLevelEditorModule& LevelEditorModule =
+			FModuleManager::GetModuleChecked<FLevelEditorModule>(TEXT("LevelEditor"));
+		TSharedPtr<SLevelViewport> ActiveViewport = LevelEditorModule.GetFirstActiveLevelViewport();
+		if (ActiveViewport.IsValid())
 		{
-			continue;
+			return &ActiveViewport->GetLevelViewportClient();
 		}
+	}
+
+	// Fallback: iterate all viewport clients.
+	for (FEditorViewportClient* VC : GEditor->GetAllViewportClients())
+	{
+		if (!VC) continue;
 		FLevelEditorViewportClient* LVC = static_cast<FLevelEditorViewportClient*>(VC);
-		if (LVC && LVC->IsVisible())
+		if (LVC)
 		{
 			return LVC;
 		}
@@ -289,16 +301,11 @@ void RegisterViewportCommands(FMCPCommandRouter& Router)
 			}
 		}
 
-		// Set global screenshot resolution and queue capture.
-		GScreenshotResolutionX = Width;
-		GScreenshotResolutionY = Height;
-		FScreenshotRequest::RequestScreenshot(false /* bShowUI */);
-
-		// Return the directory where UE will write the screenshot file.
-		const FString ShotDir = FPaths::ScreenShotDir();
+		// Use TakeScreenshotToFile which writes to MCPScreenshots/ with a known path.
+		const FString FilePath = TakeScreenshotToFile(Width, Height);
 
 		TSharedPtr<FJsonObject> Data = MakeShared<FJsonObject>();
-		Data->SetStringField(TEXT("screenshot_dir"), ShotDir);
+		Data->SetStringField(TEXT("file_path"), FilePath);
 		Data->SetNumberField(TEXT("width"),  static_cast<double>(Width));
 		Data->SetNumberField(TEXT("height"), static_cast<double>(Height));
 		Data->SetBoolField(TEXT("queued"), true);