ue-mcp 1.4.3 → 1.4.4

package/dist/tool-counts.json

@@ -34,6 +34,6 @@
   },
   "nativeToolsets": 52,
   "nativeToolActions": 830,
-  "generatedAt": "2026-10-13T15:13:53.525Z",
-  "version": "1.4.3"
+  "generatedAt": "2026-10-15T03:37:25.491Z",
+  "version": "1.4.4"
 }

package/dist/tools/material.js

@@ -31,7 +31,7 @@ export const materialTool = categoryTool("material", "Materials: create, read, p
     set_domain: specBp("mutate", "Set material domain. Required for post-process / decal / UI authoring (#299/#356).", "set_material_domain"),
     set_base_color: specBp("mutate", "Set base color.", "set_material_base_color"),
     connect_texture: specBp("mutate", "Connect texture to property.", "connect_texture_to_material"),
-    add_expression: specBp("mutate", "Add expression node (#318).", "add_material_expression"),
+    add_expression: specBp("mutate", "Add expression node (#318). Returns expressionIndex, the node's position as set_expression_value and set_custom_expression take it, and expressionName, its unique engine name.", "add_material_expression"),
     connect_expressions: specBp("mutate", "Wire two expressions.", "connect_material_expressions"),
     connect_to_property: specBp("mutate", "Wire expression to material output.", "connect_to_material_property"),
     list_expressions: specBp("read", "List expression nodes, in the material's own stored order, which is what nodeId indexes into. Set includeInputs to include each node's input wiring (default false). Paged with cursor/limit.", "list_material_expressions"),

package/dist/tools/material.js.map

@@ -1 +1 @@
-{"version":3,"file":"material.js","sourceRoot":"","sources":["../../src/tools/material.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"material.js","sourceRoot":"","sources":["../../src/tools/material.ts"],"names":[],"mappings":"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"}

package/dist/ue-mcp.default.yml

@@ -5791,9 +5791,12 @@ tasks:
     class_path: material.add_expression
     group: material
     description: >-
-      Add expression node (#318). Params: materialPath (or path, or assetPath),
-      expressionType, name? (or expressionName), parameterName?, group?,
-      sortPriority?, defaultValue?, value?, channels?, positionX?, positionY?
+      Add expression node (#318). Returns expressionIndex, the node's position
+      as set_expression_value and set_custom_expression take it, and
+      expressionName, its unique engine name. Params: materialPath (or path, or
+      assetPath), expressionType, name? (or expressionName), parameterName?,
+      group?, sortPriority?, defaultValue?, value?, channels?, positionX?,
+      positionY?
   material.connect_expressions:
     class_path: material.connect_expressions
     group: material
@@ -17503,7 +17506,7 @@ flows:
         task: material.set_expression_value
         options:
           materialPath: /Game/Flows/Beacon/M_Pillar
-          expressionIndex: 0
+          expressionIndex: ${steps.10.expressionIndex}
           value: 1
       12:
         task: material.connect_to_property
@@ -17521,7 +17524,7 @@ flows:
         task: material.set_expression_value
         options:
           materialPath: /Game/Flows/Beacon/M_Pillar
-          expressionIndex: 1
+          expressionIndex: ${steps.13.expressionIndex}
           value: 0.3
       15:
         task: material.connect_to_property
@@ -17572,7 +17575,7 @@ flows:
         task: material.set_expression_value
         options:
           materialPath: /Game/Flows/Beacon/M_Glow
-          expressionIndex: 1
+          expressionIndex: ${steps.22.expressionIndex}
           value: 50
       24:
         task: material.add_expression
@@ -17745,6 +17748,7 @@ flows:
           rotation:
             pitch: -25
             yaw: -135
+            roll: 0
       40:
         task: level.spawn_light
         options:
@@ -17852,6 +17856,7 @@ flows:
           rotation:
             pitch: -90
             yaw: 0
+            roll: 0
       52:
         task: level.spawn_light
         options:
@@ -17898,6 +17903,7 @@ flows:
           rotation:
             pitch: -15
             yaw: 30
+            roll: 0
   texture_bomb:
     description: >-
       Build a reusable MF_TextureBomb MaterialFunction (#491). Quantises UVs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ue-mcp",
-  "version": "1.4.3",
+  "version": "1.4.4",
   "description": "Unreal Engine MCP server - 26 tools, 1975+ actions for AI-driven editor control",
   "type": "module",
   "main": "dist/index.js",

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/Material/MaterialHandlers.cpp

@@ -2067,13 +2067,15 @@ TSharedPtr<FJsonValue> FMaterialHandlers::AddMaterialExpression(const TSharedPtr
 	FString SaveError;
 	const bool bSaved = SaveAssetPackageChecked(Material, SaveError);
 
-	// Return the index as nodeId for use with connect_expressions and other operations
-	int32 NodeIndex = Material->GetExpressions().Num() - 1;
+	// The node's position, as expressionIndex: the key and type set_expression_value,
+	// set_custom_expression and read_graph take it under. nodeId is the same index as text.
+	const int32 NodeIndex = Material->GetExpressions().IndexOfByKey(NewExpression);
 
 	auto Result = MCPSuccess();
 	MCPSetCreated(Result);
 	Result->SetStringField(TEXT("expressionType"), ExpressionType);
 	Result->SetStringField(TEXT("expressionClass"), NewExpression->GetClass()->GetName());
+	Result->SetNumberField(TEXT("expressionIndex"), NodeIndex);
 	Result->SetStringField(TEXT("nodeId"), FString::FromInt(NodeIndex));
 	Result->SetStringField(TEXT("description"), NewExpression->GetDescription());
 	Result->SetStringField(TEXT("materialPath"), Material->GetPathName());
@@ -3393,7 +3395,7 @@ TSharedPtr<FJsonValue> FMaterialHandlers::SetExpressionValue(const TSharedPtr<FJ
 		// Name the call that produces the index rather than only the key that is
 		// missing: this action has no name-based address, so a caller who does
 		// not already hold an index has nowhere to go from "missing parameter".
-		return MCPError(TEXT("Missing required parameter 'expressionIndex'. This action addresses nodes by POSITION in the material's expression list and has no name form; material(list_expressions) reports that list in the same order (list_function_expressions for a MaterialFunction), and add_expression returns the new node's index as nodeId."));
+		return MCPError(TEXT("Missing required parameter 'expressionIndex'. This action addresses nodes by POSITION in the material's expression list and has no name form; material(list_expressions) reports that list in the same order (list_function_expressions for a MaterialFunction), and add_expression returns the new node's index as expressionIndex."));
 	}
 
 	// #1138: a MaterialFunction graph (functionPath) is edited the same way.
@@ -3783,10 +3785,12 @@ UMaterialExpression* FMaterialHandlers::FindExpressionInList(TConstArrayView<TOb
 {
 	if (ExpressionName.IsEmpty()) return nullptr;
 
-	// Try matching by description first (most specific)
+	// Try matching by description or by Desc first (most specific). Desc is the
+	// name add_expression stores and list_expressions reports as `name`; a
+	// Constant's GetDescription is its value ("Constant (1)"), never that name.
 	for (UMaterialExpression* Expression : Expressions)
 	{
-		if (Expression && Expression->GetDescription() == ExpressionName)
+		if (Expression && (Expression->GetDescription() == ExpressionName || Expression->Desc == ExpressionName))
 		{
 			return Expression;
 		}

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Tests/MaterialExpressionLookupTests.cpp

@@ -0,0 +1,52 @@
+#if WITH_DEV_AUTOMATION_TESTS
+
+#include "HandlerRegistry.h"
+#include "Handlers/Material/MaterialHandlers.h"
+#include "Materials/Material.h"
+#include "Materials/MaterialExpressionConstant.h"
+#include "Misc/AutomationTest.h"
+#include "Misc/Guid.h"
+#include "UObject/Package.h"
+#include "UObject/StrongObjectPtr.h"
+
+IMPLEMENT_SIMPLE_AUTOMATION_TEST(
+	FMaterialExpressionLookupByDescTest,
+	"UE.MCP.Material.ExpressionLookup.ByDesc",
+	EAutomationTestFlags::EditorContext | EAutomationTestFlags::EngineFilter)
+
+// add_expression stores its `name` in Desc, and a Constant's GetDescription is
+// its value, so a name lookup that skips Desc cannot find what it just created.
+bool FMaterialExpressionLookupByDescTest::RunTest(const FString& Parameters)
+{
+	UPackage* Package = CreatePackage(*FString::Printf(TEXT("/Temp/MCPLookup_%s"), *FGuid::NewGuid().ToString(EGuidFormats::Digits)));
+	TStrongObjectPtr<UMaterial> Material(NewObject<UMaterial>(Package, TEXT("Material"), RF_Transient));
+	auto* Metallic = NewObject<UMaterialExpressionConstant>(Material.Get(), NAME_None, RF_Transient);
+	auto* Roughness = NewObject<UMaterialExpressionConstant>(Material.Get(), NAME_None, RF_Transient);
+	Metallic->Desc = TEXT("Metallic");
+	Metallic->R = 1.0f;
+	Roughness->Desc = TEXT("Roughness");
+	Roughness->R = 0.3f;
+	Material->GetExpressionCollection().AddExpression(Metallic);
+	Material->GetExpressionCollection().AddExpression(Roughness);
+
+	FMCPHandlerRegistry Registry;
+	FMaterialHandlers::RegisterHandlers(Registry);
+	auto Connect = [&](const TCHAR* Name, const TCHAR* Property) -> bool
+	{
+		auto Request = MakeShared<FJsonObject>();
+		Request->SetStringField(TEXT("materialPath"), Material->GetPathName());
+		Request->SetStringField(TEXT("expressionName"), Name);
+		Request->SetStringField(TEXT("property"), Property);
+		const auto Value = Registry.ExecuteHandler(TEXT("connect_to_material_property"), Request);
+		return Value.IsValid() && Value->Type == EJson::Object && Value->AsObject()->GetBoolField(TEXT("success"));
+	};
+
+	TestTrue(TEXT("Metallic connects by its name"), Connect(TEXT("Metallic"), TEXT("Metallic")));
+	TestTrue(TEXT("Roughness connects by its name"), Connect(TEXT("Roughness"), TEXT("Roughness")));
+	TestTrue(TEXT("Metallic input holds the node named Metallic"), Material->GetExpressionInputForProperty(MP_Metallic)->Expression == Metallic);
+	TestTrue(TEXT("Roughness input holds the node named Roughness"), Material->GetExpressionInputForProperty(MP_Roughness)->Expression == Roughness);
+	TestFalse(TEXT("an unknown name is refused"), Connect(TEXT("Specular"), TEXT("Specular")));
+	return true;
+}
+
+#endif

package/plugin/ue_mcp_bridge/UE_MCP_Bridge.uplugin

@@ -1,7 +1,7 @@
 {
 	"FileVersion": 3,
 	"Version": 1,
-	"VersionName": "1.4.3",
+	"VersionName": "1.4.4",
 	"FriendlyName": "UE MCP Bridge",
 	"Description": "C++ WebSocket bridge for UE-MCP, providing 1914+ editor actions over the MCP protocol",
 	"Category": "Developer Tools",