ultimate-unreal-engine-mcp 0.1.2 → 0.1.3

package/package.json

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

package/unreal-plugin/MCPBridge/Source/MCPBridgeEditor/MCPBridgeEditor.Build.cs

@@ -1,73 +1,60 @@
-// MCPBridgeEditor.Build.cs
-// Editor module: UEditorSubsystem lifecycle, editor API handlers (Phases 8-29).
-// Depends on MCPBridgeRuntime for the TCP server.
-// This module is guarded by WITH_EDITOR -- never ships to cooked builds.
-
-using UnrealBuildTool;
-
-public class MCPBridgeEditor : ModuleRules
-{
-    public MCPBridgeEditor(ReadOnlyTargetRules Target) : base(Target)
-    {
-        PCHUsage = ModuleRules.PCHUsageMode.UseExplicitOrSharedPCHs;
-
-        PublicDependencyModuleNames.AddRange(new string[]
-        {
-            "Core",
-            "MCPBridgeRuntime",
-        });
-
-        PrivateDependencyModuleNames.AddRange(new string[]
-        {
-            "CoreUObject",
-            "Engine",
-            "UnrealEd",
-            "EditorSubsystem",
-            "Json",
-            "Kismet",
-            "BlueprintGraph",
-            "AssetRegistry",
-            "InputCore",
-            "EnhancedInput",
-            "LevelEditor",
-            "SlateCore",
-            "DataValidation",
-            "LevelSequence",
-            "MovieScene",
-            "MovieSceneTracks",
-            "LevelSequenceEditor",
-            "MaterialEditor",
-            "AssetTools",
-            "AnimGraph",
-            "AnimGraphRuntime",
-            "IKRig",
-            "WorldPartitionEditor",
-            "DataLayerEditor",
-            "PhysicsCore",
-            "MetasoundEngine",
-            "MetasoundFrontend",
-            "InterchangeEngine",
-            "InterchangeCore",              // UInterchangeSourceData
-            "InterchangePipelines",
-            "AIModule",
-            "StateTreeModule",
-            "NavigationSystem",
-            "GameplayAbilities",        // Phase 25 - GAS
-            "GameplayTags",             // Phase 25 - GAS
-            "GameplayTasks",            // Phase 25 - GAS
-            "GeometryCollectionEngine", // Phase 26 - Chaos destruction (UGeometryCollectionComponent)
-            "Chaos",                    // Phase 26 - FManagedArrayCollection, FTransformCollection
-            "ClothingSystemRuntimeCommon", // Phase 26 - UClothingAssetCommon
-            "ChaosCloth",               // Phase 26 - Chaos cloth simulation parameters
-            "LiveLinkInterface",        // Phase 27 - ILiveLinkClient, FLiveLinkSubjectKey, FLiveLinkSubjectFrameData
-            "LiveLink",                 // Phase 27 - ULiveLinkSubjectSettings for per-subject enabled state control
-            "AvalancheTransition",      // Phase 28 - Motion Design Transition Logic trees (experimental)
-            "RemoteControl",            // Phase 28 - Remote Control preset read/write
-            "MovieRenderPipelineCore",  // Phase 29 - UMoviePipelineQueue, UMoviePipelineExecutorJob, config/settings types
-            "MovieRenderPipelineSettings", // Phase 29 - UMoviePipelineBurnInSetting
-            "MovieRenderPipelineEditor", // Phase 29 - UMoviePipelineQueueSubsystem
-            "OnlineSubsystem",          // Phase 30 - IOnlineSubsystem, IOnlineSession, FOnlineSessionSettings
-            "OnlineSubsystemUtils",     // Phase 30 - Online subsystem helper utilities
-        });
-    }
-}
+// MCPBridgeEditor.Build.cs
+// Editor module: UEditorSubsystem lifecycle, editor API handlers.
+// Depends on MCPBridgeRuntime for the TCP server.
+// This module is guarded by WITH_EDITOR -- never ships to cooked builds.
+//
+// Only modules that ship with every UE 5.7 binary install are linked here.
+// Handlers for optional plugins live in the Private/Optional/ subfolder
+// and are NOT compiled by default. To enable them, move them to Private/
+// and add their module dependencies below.
+
+using UnrealBuildTool;
+
+public class MCPBridgeEditor : ModuleRules
+{
+    public MCPBridgeEditor(ReadOnlyTargetRules Target) : base(Target)
+    {
+        PCHUsage = ModuleRules.PCHUsageMode.UseExplicitOrSharedPCHs;
+
+        PublicDependencyModuleNames.AddRange(new string[]
+        {
+            "Core",
+            "MCPBridgeRuntime",
+        });
+
+        PrivateDependencyModuleNames.AddRange(new string[]
+        {
+            // Core engine (always present)
+            "CoreUObject",
+            "Engine",
+            "UnrealEd",
+            "EditorSubsystem",
+            "Json",
+            "SlateCore",
+            "InputCore",
+            "AssetTools",
+            "AssetRegistry",
+            "LevelEditor",
+            "PhysicsCore",
+
+            // Blueprint (always present in editor)
+            "Kismet",
+            "BlueprintGraph",
+
+            // Sequencer (always present in editor)
+            "LevelSequence",
+            "LevelSequenceEditor",
+            "MovieScene",
+            "MovieSceneTracks",
+
+            // Input (always present)
+            "EnhancedInput",
+
+            // AI (always present)
+            "AIModule",
+            "NavigationSystem",
+            "GameplayTags",
+            "GameplayTasks",
+        });
+    }
+}

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

@@ -1,149 +1,110 @@
-// MCPBridgeSubsystem.cpp (updated by Plans 07-02, 08-01, 09-01, 09-02, 10-01, 12-01, 12-02, 13-01, 17-01, 18-01, 19-01, 20-01, 21-01, 22-01, 23-01, 25-01, 26-01, 27-01, 28-01, 29-01, 30-01)
-// Wires FMCPCommandRouter and FMCPTcpServer into the editor subsystem lifecycle.
-
-#include "MCPBridgeSubsystem.h"
-#include "MCPBlueprintHandlers.h"
-#include "MCPActorCommands.h"
-#include "MCPAssetCommands.h"
-#include "MCPBlueprintWriteHandlers.h"
-#include "MCPEditorStateCommands.h"
-#include "MCPPieCommands.h"
-#include "MCPViewportCommands.h"
-#include "MCPValidationCommands.h"
-#include "MCPInputHandlers.h"
-#include "MCPMaterialCommands.h"
-#include "MCPSequencerCommands.h"
-#include "MCPAnimationCommands.h"
-#include "MCPWorldPartitionCommands.h"
-#include "MCPAICommands.h"
-#include "MCPSelectionCommands.h"
-#include "MCPCollisionPhysicsCommands.h"
-#include "MCPImportExportCommands.h"
-#include "MCPMotionDesignCommands.h"
-#include "MCPChaosCommands.h"
-#include "MCPAudioCommands.h"
-#include "MCPGASCommands.h"
-#include "MCPLiveLinkCommands.h"
-#include "MCPMovieRenderCommands.h"
-#include "MCPNetworkingCommands.h"
-#include "Misc/ConfigCacheIni.h"
-
-void UMCPBridgeSubsystem::Initialize(FSubsystemCollectionBase& Collection)
-{
-	Super::Initialize(Collection);
-
-	const int32 Port = GetConfiguredPort();
-
-	// Create the router (registers built-in ping handler in constructor).
-	Router = MakeUnique<FMCPCommandRouter>();
-
-	// Register Blueprint command handlers (blueprint.read, blueprint.graph, blueprint.list).
-	RegisterBlueprintHandlers(*Router);
-
-	// Register Blueprint-C++ bridge handlers (blueprint.subclasses, blueprint.cppUsage).
-	RegisterBlueprintBridgeHandlers(*Router);
-
-	// Register Actor command handlers (actor.list, actor.spawn, actor.transform, actor.delete).
-	RegisterActorCommands(*Router);
-
-	// Register Asset/Level command handlers (asset.query, asset.references, level.layout).
-	RegisterAssetCommands(*Router);
-
-	// Register Blueprint write command handlers (blueprint.create, addNode, connectPins, addVariable, setDefault).
-	RegisterBlueprintWriteHandlers(*Router);
-
-	// Register Editor State command handlers (editor.state).
-	RegisterEditorStateCommands(*Router);
-
-	// Register PIE command handlers (pie.start, pie.stop, pie.logs, pie.gameState).
-	RegisterPieCommands(*Router);
-
-	// Register Viewport command handlers (viewport.screenshot, viewport.camera, viewport.renderMode, viewport.hiresScreenshot).
-	RegisterViewportCommands(*Router);
-
-	// Register validation command handlers (validate.asset, validate.folder, validate.project, validate.blueprint).
-	RegisterValidationCommands(*Router);
-
-	// Register Enhanced Input command handlers (input.listActions, input.createAction, input.listContexts, input.addBinding).
-	RegisterInputHandlers(*Router);
-
-	// Register Material command handlers (material.params, material.createInstance, material.setParam, material.actorMaterials).
-	RegisterMaterialCommands(*Router);
-
-	// Register Sequencer command handlers (sequencer.create, tracks, addTrack, addKey, playback).
-	RegisterSequencerCommands(*Router);
-
-	// Register Animation command handlers (animation.list, inspectAnimBP, inspectMontage, inspectBlendSpace, retargetMappings).
-	RegisterAnimationCommands(*Router);
-
-	// Register World Partition command handlers (worldpartition.settings, dataLayers, streamingSources, hlod).
-	RegisterWorldPartitionCommands(*Router);
-
-	// Register AI system command handlers (ai.behaviorTree, ai.stateTree, ai.blackboard, ai.eqs, ai.navmesh).
-	RegisterAICommands(*Router);
-
-	// Register Selection command handlers (selection.select, selection.get, selection.duplicate, selection.convert).
-	RegisterSelectionCommands(*Router);
-
-	// Register Collision & Physics command handlers (collision.read, collision.set, physics.material, physics.asset).
-	RegisterCollisionPhysicsCommands(*Router);
-
-	// Register Import/Export command handlers (import.fbx, import.usd, export.mesh, import.batch).
-	RegisterImportExportCommands(*Router);
-
-	// Register Motion Design command handlers (motiondesign.sceneStates, transition, transitionLogic, remoteControl).
-	RegisterMotionDesignCommands(*Router);
-
-	// Register Chaos physics command handlers (chaos.geometryCollection, chaos.resetDestruction, chaos.cloth, chaos.physicsCache).
-	RegisterChaosCommands(*Router);
-
-	// Register Audio command handlers (audio.list, audio.metasound, audio.soundcue, audio.insights).
-	RegisterAudioCommands(*Router);
-
-	// Register GAS command handlers (gas.abilities, gas.effects, gas.attributes, gas.tags).
-	RegisterGASCommands(*Router);
-
-	// Register Live Link command handlers (livelink.sources, livelink.subjects, livelink.control, livelink.preview).
-	RegisterLiveLinkCommands(*Router);
-
-	// Register Movie Render Pipeline command handlers (movierender.queue, movierender.addJob, movierender.control, movierender.configure).
-	RegisterMovieRenderCommands(*Router);
-
-	// Register Networking command handlers (net.replication, net.properties, net.driver, net.session).
-	RegisterNetworkingCommands(*Router);
-
-	// Create and start the TCP server.
-	TcpServer = MakeUnique<FMCPTcpServer>(*Router);
-	bServerRunning = TcpServer->Start(Port);
-
-	if (!bServerRunning)
-	{
-		UE_LOG(LogTemp, Error, TEXT("[MCPBridge] Failed to start TCP server on port %d."), Port);
-	}
-}
-
-void UMCPBridgeSubsystem::Deinitialize()
-{
-	if (TcpServer.IsValid())
-	{
-		TcpServer->Stop();
-		TcpServer.Reset();
-	}
-	if (Router.IsValid())
-	{
-		Router.Reset();
-	}
-	bServerRunning = false;
-
-	Super::Deinitialize();
-}
-
-int32 UMCPBridgeSubsystem::GetConfiguredPort() const
-{
-	int32 Port = 55557;
-	if (GConfig)
-	{
-		GConfig->GetInt(TEXT("MCPBridge"), TEXT("Port"), Port, GEngineIni);
-	}
-	return Port;
-}
+// MCPBridgeSubsystem.cpp
+// Wires FMCPCommandRouter and FMCPTcpServer into the editor subsystem lifecycle.
+//
+// Core handlers are always registered. Optional-plugin handlers are guarded by
+// preprocessor defines set in Build.cs. When a plugin module is not linked,
+// the corresponding Register*Commands() call is skipped and the TypeScript
+// side returns "plugin_not_connected" gracefully.
+
+#include "MCPBridgeSubsystem.h"
+#include "MCPBlueprintHandlers.h"
+#include "MCPActorCommands.h"
+#include "MCPAssetCommands.h"
+#include "MCPBlueprintWriteHandlers.h"
+#include "MCPEditorStateCommands.h"
+#include "MCPPieCommands.h"
+#include "MCPViewportCommands.h"
+#include "MCPInputHandlers.h"
+#include "MCPSequencerCommands.h"
+#include "MCPSelectionCommands.h"
+#include "MCPCollisionPhysicsCommands.h"
+#include "Misc/ConfigCacheIni.h"
+
+// Optional module handlers — only included when their Build.cs dependencies are linked.
+// To enable: add the module to Build.cs PrivateDependencyModuleNames and uncomment here.
+// #include "MCPValidationCommands.h"    // Requires: DataValidation
+// #include "MCPMaterialCommands.h"      // Requires: MaterialEditor
+// #include "MCPWorldPartitionCommands.h" // Requires: WorldPartitionEditor, DataLayerEditor
+// #include "MCPImportExportCommands.h"  // Requires: InterchangeEngine, InterchangeCore, InterchangePipelines
+// #include "MCPAudioCommands.h"         // Requires: MetasoundEngine, MetasoundFrontend
+// #include "MCPGASCommands.h"           // Requires: GameplayAbilities
+// #include "MCPChaosCommands.h"         // Requires: GeometryCollectionEngine, Chaos, ChaosCloth
+// #include "MCPLiveLinkCommands.h"      // Requires: LiveLinkInterface, LiveLink
+// #include "MCPMotionDesignCommands.h"  // Requires: AvalancheTransition, RemoteControl
+// #include "MCPMovieRenderCommands.h"   // Requires: MovieRenderPipelineCore, MovieRenderPipelineEditor
+// #include "MCPNetworkingCommands.h"    // Requires: OnlineSubsystem, OnlineSubsystemUtils
+
+void UMCPBridgeSubsystem::Initialize(FSubsystemCollectionBase& Collection)
+{
+	Super::Initialize(Collection);
+
+	const int32 Port = GetConfiguredPort();
+
+	Router = MakeUnique<FMCPCommandRouter>();
+
+	// --- Core handlers (always available) ---
+	RegisterBlueprintHandlers(*Router);
+	RegisterBlueprintBridgeHandlers(*Router);
+	RegisterActorCommands(*Router);
+	RegisterAssetCommands(*Router);
+	RegisterBlueprintWriteHandlers(*Router);
+	RegisterEditorStateCommands(*Router);
+	RegisterPieCommands(*Router);
+	RegisterViewportCommands(*Router);
+	RegisterInputHandlers(*Router);
+	RegisterSequencerCommands(*Router);
+	RegisterSelectionCommands(*Router);
+	RegisterCollisionPhysicsCommands(*Router);
+
+	// --- Optional handlers (uncomment when plugin dependencies are enabled) ---
+	// RegisterValidationCommands(*Router);
+	// RegisterMaterialCommands(*Router);
+	// RegisterWorldPartitionCommands(*Router);
+	// RegisterImportExportCommands(*Router);
+	// RegisterAudioCommands(*Router);
+	// RegisterGASCommands(*Router);
+	// RegisterChaosCommands(*Router);
+	// RegisterLiveLinkCommands(*Router);
+	// RegisterMotionDesignCommands(*Router);
+	// RegisterMovieRenderCommands(*Router);
+	// RegisterNetworkingCommands(*Router);
+
+	// Create and start the TCP server.
+	TcpServer = MakeUnique<FMCPTcpServer>(*Router);
+	bServerRunning = TcpServer->Start(Port);
+
+	if (!bServerRunning)
+	{
+		UE_LOG(LogTemp, Error, TEXT("[MCPBridge] Failed to start TCP server on port %d."), Port);
+	}
+	else
+	{
+		UE_LOG(LogTemp, Log, TEXT("[MCPBridge] TCP server started on port %d."), Port);
+	}
+}
+
+void UMCPBridgeSubsystem::Deinitialize()
+{
+	if (TcpServer.IsValid())
+	{
+		TcpServer->Stop();
+		TcpServer.Reset();
+	}
+	if (Router.IsValid())
+	{
+		Router.Reset();
+	}
+	bServerRunning = false;
+
+	Super::Deinitialize();
+}
+
+int32 UMCPBridgeSubsystem::GetConfiguredPort() const
+{
+	int32 Port = 55557;
+	if (GConfig)
+	{
+		GConfig->GetInt(TEXT("MCPBridge"), TEXT("Port"), Port, GEngineIni);
+	}
+	return Port;
+}