unreal-engine-mcp-server 0.4.7 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.env.example +26 -0
- package/.env.production +38 -7
- package/.eslintrc.json +0 -54
- package/.eslintrc.override.json +8 -0
- package/.github/ISSUE_TEMPLATE/bug_report.yml +94 -0
- package/.github/ISSUE_TEMPLATE/config.yml +8 -0
- package/.github/ISSUE_TEMPLATE/feature_request.yml +56 -0
- package/.github/copilot-instructions.md +478 -45
- package/.github/dependabot.yml +19 -0
- package/.github/labeler.yml +24 -0
- package/.github/labels.yml +70 -0
- package/.github/pull_request_template.md +42 -0
- package/.github/release-drafter.yml +148 -0
- package/.github/workflows/auto-merge.yml +38 -0
- package/.github/workflows/ci.yml +38 -0
- package/.github/workflows/dependency-review.yml +17 -0
- package/.github/workflows/gemini-issue-triage.yml +172 -0
- package/.github/workflows/greetings.yml +23 -0
- package/.github/workflows/labeler.yml +16 -0
- package/.github/workflows/links.yml +80 -0
- package/.github/workflows/pr-size-labeler.yml +137 -0
- package/.github/workflows/publish-mcp.yml +12 -7
- package/.github/workflows/release-drafter.yml +23 -0
- package/.github/workflows/release.yml +112 -0
- package/.github/workflows/semantic-pull-request.yml +35 -0
- package/.github/workflows/smoke-test.yml +36 -0
- package/.github/workflows/stale.yml +28 -0
- package/CHANGELOG.md +267 -31
- package/CONTRIBUTING.md +140 -0
- package/README.md +166 -71
- package/claude_desktop_config_example.json +7 -6
- package/dist/automation/bridge.d.ts +50 -0
- package/dist/automation/bridge.js +452 -0
- package/dist/automation/connection-manager.d.ts +23 -0
- package/dist/automation/connection-manager.js +107 -0
- package/dist/automation/handshake.d.ts +11 -0
- package/dist/automation/handshake.js +89 -0
- package/dist/automation/index.d.ts +3 -0
- package/dist/automation/index.js +3 -0
- package/dist/automation/message-handler.d.ts +12 -0
- package/dist/automation/message-handler.js +149 -0
- package/dist/automation/request-tracker.d.ts +25 -0
- package/dist/automation/request-tracker.js +98 -0
- package/dist/automation/types.d.ts +130 -0
- package/dist/automation/types.js +2 -0
- package/dist/cli.js +32 -5
- package/dist/config.d.ts +27 -0
- package/dist/config.js +60 -0
- package/dist/constants.d.ts +12 -0
- package/dist/constants.js +12 -0
- package/dist/graphql/resolvers.d.ts +268 -0
- package/dist/graphql/resolvers.js +743 -0
- package/dist/graphql/schema.d.ts +5 -0
- package/dist/graphql/schema.js +437 -0
- package/dist/graphql/server.d.ts +26 -0
- package/dist/graphql/server.js +115 -0
- package/dist/graphql/types.d.ts +7 -0
- package/dist/graphql/types.js +2 -0
- package/dist/handlers/resource-handlers.d.ts +20 -0
- package/dist/handlers/resource-handlers.js +180 -0
- package/dist/index.d.ts +31 -18
- package/dist/index.js +119 -619
- package/dist/prompts/index.js +4 -4
- package/dist/resources/actors.d.ts +17 -12
- package/dist/resources/actors.js +56 -76
- package/dist/resources/assets.d.ts +6 -14
- package/dist/resources/assets.js +115 -147
- package/dist/resources/levels.d.ts +13 -13
- package/dist/resources/levels.js +25 -34
- package/dist/server/resource-registry.d.ts +20 -0
- package/dist/server/resource-registry.js +37 -0
- package/dist/server/tool-registry.d.ts +23 -0
- package/dist/server/tool-registry.js +322 -0
- package/dist/server-setup.d.ts +21 -0
- package/dist/server-setup.js +111 -0
- package/dist/services/health-monitor.d.ts +34 -0
- package/dist/services/health-monitor.js +105 -0
- package/dist/services/metrics-server.d.ts +11 -0
- package/dist/services/metrics-server.js +105 -0
- package/dist/tools/actors.d.ts +147 -9
- package/dist/tools/actors.js +350 -311
- package/dist/tools/animation.d.ts +135 -4
- package/dist/tools/animation.js +510 -411
- package/dist/tools/assets.d.ts +117 -19
- package/dist/tools/assets.js +259 -284
- package/dist/tools/audio.d.ts +102 -42
- package/dist/tools/audio.js +272 -685
- package/dist/tools/base-tool.d.ts +17 -0
- package/dist/tools/base-tool.js +46 -0
- package/dist/tools/behavior-tree.d.ts +94 -0
- package/dist/tools/behavior-tree.js +39 -0
- package/dist/tools/blueprint/helpers.d.ts +29 -0
- package/dist/tools/blueprint/helpers.js +182 -0
- package/dist/tools/blueprint.d.ts +228 -118
- package/dist/tools/blueprint.js +685 -832
- package/dist/tools/consolidated-tool-definitions.d.ts +5462 -1781
- package/dist/tools/consolidated-tool-definitions.js +829 -496
- package/dist/tools/consolidated-tool-handlers.d.ts +2 -1
- package/dist/tools/consolidated-tool-handlers.js +211 -1026
- package/dist/tools/debug.d.ts +143 -85
- package/dist/tools/debug.js +234 -180
- package/dist/tools/dynamic-handler-registry.d.ts +11 -0
- package/dist/tools/dynamic-handler-registry.js +101 -0
- package/dist/tools/editor.d.ts +139 -18
- package/dist/tools/editor.js +239 -244
- package/dist/tools/engine.d.ts +10 -4
- package/dist/tools/engine.js +13 -5
- package/dist/tools/environment.d.ts +36 -0
- package/dist/tools/environment.js +267 -0
- package/dist/tools/foliage.d.ts +105 -14
- package/dist/tools/foliage.js +219 -331
- package/dist/tools/handlers/actor-handlers.d.ts +3 -0
- package/dist/tools/handlers/actor-handlers.js +232 -0
- package/dist/tools/handlers/animation-handlers.d.ts +3 -0
- package/dist/tools/handlers/animation-handlers.js +185 -0
- package/dist/tools/handlers/argument-helper.d.ts +16 -0
- package/dist/tools/handlers/argument-helper.js +80 -0
- package/dist/tools/handlers/asset-handlers.d.ts +3 -0
- package/dist/tools/handlers/asset-handlers.js +496 -0
- package/dist/tools/handlers/audio-handlers.d.ts +3 -0
- package/dist/tools/handlers/audio-handlers.js +166 -0
- package/dist/tools/handlers/blueprint-handlers.d.ts +4 -0
- package/dist/tools/handlers/blueprint-handlers.js +358 -0
- package/dist/tools/handlers/common-handlers.d.ts +14 -0
- package/dist/tools/handlers/common-handlers.js +56 -0
- package/dist/tools/handlers/editor-handlers.d.ts +3 -0
- package/dist/tools/handlers/editor-handlers.js +119 -0
- package/dist/tools/handlers/effect-handlers.d.ts +3 -0
- package/dist/tools/handlers/effect-handlers.js +171 -0
- package/dist/tools/handlers/environment-handlers.d.ts +3 -0
- package/dist/tools/handlers/environment-handlers.js +170 -0
- package/dist/tools/handlers/graph-handlers.d.ts +3 -0
- package/dist/tools/handlers/graph-handlers.js +90 -0
- package/dist/tools/handlers/input-handlers.d.ts +3 -0
- package/dist/tools/handlers/input-handlers.js +21 -0
- package/dist/tools/handlers/inspect-handlers.d.ts +3 -0
- package/dist/tools/handlers/inspect-handlers.js +383 -0
- package/dist/tools/handlers/level-handlers.d.ts +3 -0
- package/dist/tools/handlers/level-handlers.js +237 -0
- package/dist/tools/handlers/lighting-handlers.d.ts +3 -0
- package/dist/tools/handlers/lighting-handlers.js +144 -0
- package/dist/tools/handlers/performance-handlers.d.ts +3 -0
- package/dist/tools/handlers/performance-handlers.js +130 -0
- package/dist/tools/handlers/pipeline-handlers.d.ts +3 -0
- package/dist/tools/handlers/pipeline-handlers.js +110 -0
- package/dist/tools/handlers/sequence-handlers.d.ts +3 -0
- package/dist/tools/handlers/sequence-handlers.js +376 -0
- package/dist/tools/handlers/system-handlers.d.ts +4 -0
- package/dist/tools/handlers/system-handlers.js +506 -0
- package/dist/tools/input.d.ts +19 -0
- package/dist/tools/input.js +89 -0
- package/dist/tools/introspection.d.ts +103 -40
- package/dist/tools/introspection.js +425 -568
- package/dist/tools/landscape.d.ts +97 -36
- package/dist/tools/landscape.js +280 -409
- package/dist/tools/level.d.ts +130 -10
- package/dist/tools/level.js +639 -675
- package/dist/tools/lighting.d.ts +77 -38
- package/dist/tools/lighting.js +441 -943
- package/dist/tools/logs.d.ts +3 -3
- package/dist/tools/logs.js +5 -57
- package/dist/tools/materials.d.ts +91 -24
- package/dist/tools/materials.js +190 -118
- package/dist/tools/niagara.d.ts +149 -39
- package/dist/tools/niagara.js +232 -182
- package/dist/tools/performance.d.ts +27 -12
- package/dist/tools/performance.js +204 -122
- package/dist/tools/physics.d.ts +32 -77
- package/dist/tools/physics.js +171 -582
- package/dist/tools/property-dictionary.d.ts +13 -0
- package/dist/tools/property-dictionary.js +82 -0
- package/dist/tools/sequence.d.ts +73 -48
- package/dist/tools/sequence.js +196 -748
- package/dist/tools/tool-definition-utils.d.ts +59 -0
- package/dist/tools/tool-definition-utils.js +35 -0
- package/dist/tools/ui.d.ts +66 -34
- package/dist/tools/ui.js +134 -214
- package/dist/types/env.d.ts +0 -3
- package/dist/types/env.js +0 -7
- package/dist/types/tool-interfaces.d.ts +898 -0
- package/dist/types/tool-interfaces.js +2 -0
- package/dist/types/tool-types.d.ts +183 -19
- package/dist/types/tool-types.js +0 -4
- package/dist/unreal-bridge.d.ts +24 -131
- package/dist/unreal-bridge.js +364 -1506
- package/dist/utils/command-validator.d.ts +9 -0
- package/dist/utils/command-validator.js +67 -0
- package/dist/utils/elicitation.d.ts +1 -1
- package/dist/utils/elicitation.js +12 -15
- package/dist/utils/error-handler.d.ts +2 -51
- package/dist/utils/error-handler.js +11 -87
- package/dist/utils/ini-reader.d.ts +3 -0
- package/dist/utils/ini-reader.js +69 -0
- package/dist/utils/logger.js +9 -6
- package/dist/utils/normalize.d.ts +3 -0
- package/dist/utils/normalize.js +56 -0
- package/dist/utils/response-factory.d.ts +7 -0
- package/dist/utils/response-factory.js +33 -0
- package/dist/utils/response-validator.d.ts +3 -24
- package/dist/utils/response-validator.js +130 -81
- package/dist/utils/result-helpers.d.ts +4 -5
- package/dist/utils/result-helpers.js +15 -16
- package/dist/utils/safe-json.js +5 -11
- package/dist/utils/unreal-command-queue.d.ts +24 -0
- package/dist/utils/unreal-command-queue.js +120 -0
- package/dist/utils/validation.d.ts +0 -40
- package/dist/utils/validation.js +1 -78
- package/dist/wasm/index.d.ts +70 -0
- package/dist/wasm/index.js +535 -0
- package/docs/GraphQL-API.md +888 -0
- package/docs/Migration-Guide-v0.5.0.md +692 -0
- package/docs/Roadmap.md +53 -0
- package/docs/WebAssembly-Integration.md +628 -0
- package/docs/editor-plugin-extension.md +370 -0
- package/docs/handler-mapping.md +242 -0
- package/docs/native-automation-progress.md +128 -0
- package/docs/testing-guide.md +423 -0
- package/mcp-config-example.json +6 -6
- package/package.json +60 -27
- package/plugins/McpAutomationBridge/Config/FilterPlugin.ini +8 -0
- package/plugins/McpAutomationBridge/McpAutomationBridge.uplugin +64 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/McpAutomationBridge.Build.cs +189 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeGlobals.cpp +22 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeGlobals.h +30 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeHelpers.h +1983 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeModule.cpp +72 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeSettings.cpp +46 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeSubsystem.cpp +581 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_AnimationHandlers.cpp +2394 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_AssetQueryHandlers.cpp +300 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_AssetWorkflowHandlers.cpp +2807 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_AudioHandlers.cpp +1087 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BehaviorTreeHandlers.cpp +488 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintCreationHandlers.cpp +643 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintCreationHandlers.h +31 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintGraphHandlers.cpp +1184 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintHandlers.cpp +5652 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintHandlers_List.cpp +152 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_ControlHandlers.cpp +2614 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_DebugHandlers.cpp +42 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_EditorFunctionHandlers.cpp +1237 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_EffectHandlers.cpp +1701 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_EnvironmentHandlers.cpp +2145 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_FoliageHandlers.cpp +954 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_InputHandlers.cpp +209 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_InsightsHandlers.cpp +41 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_LandscapeHandlers.cpp +1164 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_LevelHandlers.cpp +762 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_LightingHandlers.cpp +634 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_LogHandlers.cpp +136 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_MaterialGraphHandlers.cpp +494 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_NiagaraGraphHandlers.cpp +278 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_NiagaraHandlers.cpp +625 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_PerformanceHandlers.cpp +401 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_PipelineHandlers.cpp +67 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_ProcessRequest.cpp +735 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_PropertyHandlers.cpp +2634 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_RenderHandlers.cpp +189 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_SCSHandlers.cpp +917 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_SCSHandlers.h +39 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_SequenceHandlers.cpp +2670 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_SequencerHandlers.cpp +519 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_TestHandlers.cpp +38 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_UiHandlers.cpp +668 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_WorldPartitionHandlers.cpp +346 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpBridgeWebSocket.cpp +1330 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpBridgeWebSocket.h +149 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpConnectionManager.cpp +783 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Public/McpAutomationBridgeSettings.h +115 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Public/McpAutomationBridgeSubsystem.h +796 -0
- package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Public/McpConnectionManager.h +117 -0
- package/scripts/check-unreal-connection.mjs +19 -0
- package/scripts/clean-tmp.js +23 -0
- package/scripts/patch-wasm.js +26 -0
- package/scripts/run-all-tests.mjs +131 -0
- package/scripts/smoke-test.ts +94 -0
- package/scripts/sync-mcp-plugin.js +143 -0
- package/scripts/test-no-plugin-alternates.mjs +113 -0
- package/scripts/validate-server.js +46 -0
- package/scripts/verify-automation-bridge.js +200 -0
- package/server.json +57 -21
- package/src/automation/bridge.ts +558 -0
- package/src/automation/connection-manager.ts +130 -0
- package/src/automation/handshake.ts +99 -0
- package/src/automation/index.ts +2 -0
- package/src/automation/message-handler.ts +167 -0
- package/src/automation/request-tracker.ts +123 -0
- package/src/automation/types.ts +107 -0
- package/src/cli.ts +33 -6
- package/src/config.ts +73 -0
- package/src/constants.ts +12 -0
- package/src/graphql/resolvers.ts +1010 -0
- package/src/graphql/schema.ts +452 -0
- package/src/graphql/server.ts +154 -0
- package/src/graphql/types.ts +7 -0
- package/src/handlers/resource-handlers.ts +186 -0
- package/src/index.ts +152 -663
- package/src/prompts/index.ts +4 -4
- package/src/resources/actors.ts +58 -76
- package/src/resources/assets.ts +147 -134
- package/src/resources/levels.ts +28 -33
- package/src/server/resource-registry.ts +47 -0
- package/src/server/tool-registry.ts +354 -0
- package/src/server-setup.ts +148 -0
- package/src/services/health-monitor.ts +132 -0
- package/src/services/metrics-server.ts +142 -0
- package/src/tools/actors.ts +417 -322
- package/src/tools/animation.ts +671 -461
- package/src/tools/assets.ts +353 -289
- package/src/tools/audio.ts +323 -766
- package/src/tools/base-tool.ts +52 -0
- package/src/tools/behavior-tree.ts +45 -0
- package/src/tools/blueprint/helpers.ts +189 -0
- package/src/tools/blueprint.ts +787 -965
- package/src/tools/consolidated-tool-definitions.ts +993 -515
- package/src/tools/consolidated-tool-handlers.ts +272 -1139
- package/src/tools/debug.ts +292 -187
- package/src/tools/dynamic-handler-registry.ts +151 -0
- package/src/tools/editor.ts +309 -246
- package/src/tools/engine.ts +14 -3
- package/src/tools/environment.ts +287 -0
- package/src/tools/foliage.ts +314 -379
- package/src/tools/handlers/actor-handlers.ts +271 -0
- package/src/tools/handlers/animation-handlers.ts +237 -0
- package/src/tools/handlers/argument-helper.ts +142 -0
- package/src/tools/handlers/asset-handlers.ts +532 -0
- package/src/tools/handlers/audio-handlers.ts +194 -0
- package/src/tools/handlers/blueprint-handlers.ts +380 -0
- package/src/tools/handlers/common-handlers.ts +87 -0
- package/src/tools/handlers/editor-handlers.ts +123 -0
- package/src/tools/handlers/effect-handlers.ts +220 -0
- package/src/tools/handlers/environment-handlers.ts +183 -0
- package/src/tools/handlers/graph-handlers.ts +116 -0
- package/src/tools/handlers/input-handlers.ts +28 -0
- package/src/tools/handlers/inspect-handlers.ts +450 -0
- package/src/tools/handlers/level-handlers.ts +252 -0
- package/src/tools/handlers/lighting-handlers.ts +147 -0
- package/src/tools/handlers/performance-handlers.ts +132 -0
- package/src/tools/handlers/pipeline-handlers.ts +127 -0
- package/src/tools/handlers/sequence-handlers.ts +415 -0
- package/src/tools/handlers/system-handlers.ts +564 -0
- package/src/tools/input.ts +101 -0
- package/src/tools/introspection.ts +493 -584
- package/src/tools/landscape.ts +394 -489
- package/src/tools/level.ts +752 -694
- package/src/tools/lighting.ts +583 -984
- package/src/tools/logs.ts +9 -57
- package/src/tools/materials.ts +231 -121
- package/src/tools/niagara.ts +293 -168
- package/src/tools/performance.ts +320 -168
- package/src/tools/physics.ts +268 -613
- package/src/tools/property-dictionary.ts +98 -0
- package/src/tools/sequence.ts +255 -815
- package/src/tools/tool-definition-utils.ts +35 -0
- package/src/tools/ui.ts +207 -283
- package/src/types/env.ts +0 -10
- package/src/types/tool-interfaces.ts +250 -0
- package/src/types/tool-types.ts +243 -21
- package/src/unreal-bridge.ts +460 -1550
- package/src/utils/command-validator.ts +75 -0
- package/src/utils/elicitation.ts +10 -7
- package/src/utils/error-handler.ts +14 -90
- package/src/utils/ini-reader.ts +86 -0
- package/src/utils/logger.ts +8 -3
- package/src/utils/normalize.ts +60 -0
- package/src/utils/response-factory.ts +39 -0
- package/src/utils/response-validator.ts +176 -56
- package/src/utils/result-helpers.ts +21 -19
- package/src/utils/safe-json.ts +14 -11
- package/src/utils/unreal-command-queue.ts +152 -0
- package/src/utils/validation.ts +4 -1
- package/src/wasm/index.ts +838 -0
- package/test-server.mjs +100 -0
- package/tests/run-unreal-tool-tests.mjs +242 -14
- package/tests/test-animation.mjs +44 -0
- package/tests/test-asset-advanced.mjs +82 -0
- package/tests/test-asset-errors.mjs +35 -0
- package/tests/test-audio.mjs +219 -0
- package/tests/test-automation-timeouts.mjs +98 -0
- package/tests/test-behavior-tree.mjs +261 -0
- package/tests/test-blueprint-events.mjs +35 -0
- package/tests/test-blueprint-graph.mjs +79 -0
- package/tests/test-blueprint.mjs +577 -0
- package/tests/test-client-mode.mjs +86 -0
- package/tests/test-console-command.mjs +56 -0
- package/tests/test-control-actor.mjs +425 -0
- package/tests/test-control-editor.mjs +80 -0
- package/tests/test-extra-tools.mjs +38 -0
- package/tests/test-graphql.mjs +322 -0
- package/tests/test-inspect.mjs +72 -0
- package/tests/test-landscape.mjs +60 -0
- package/tests/test-manage-asset.mjs +438 -0
- package/tests/test-manage-level.mjs +70 -0
- package/tests/test-materials.mjs +356 -0
- package/tests/test-niagara.mjs +185 -0
- package/tests/test-no-inline-python.mjs +122 -0
- package/tests/test-plugin-handshake.mjs +82 -0
- package/tests/test-render.mjs +33 -0
- package/tests/test-runner.mjs +933 -0
- package/tests/test-search-assets.mjs +66 -0
- package/tests/test-sequence.mjs +68 -0
- package/tests/test-system.mjs +57 -0
- package/tests/test-wasm.mjs +193 -0
- package/tests/test-world-partition.mjs +215 -0
- package/tsconfig.json +3 -3
- package/wasm/Cargo.lock +363 -0
- package/wasm/Cargo.toml +42 -0
- package/wasm/LICENSE +21 -0
- package/wasm/README.md +253 -0
- package/wasm/src/dependency_resolver.rs +377 -0
- package/wasm/src/lib.rs +153 -0
- package/wasm/src/property_parser.rs +271 -0
- package/wasm/src/transform_math.rs +396 -0
- package/wasm/tests/integration.rs +109 -0
- package/.github/workflows/smithery-build.yml +0 -29
- package/dist/tools/build_environment_advanced.d.ts +0 -65
- package/dist/tools/build_environment_advanced.js +0 -633
- package/dist/tools/rc.d.ts +0 -110
- package/dist/tools/rc.js +0 -437
- package/dist/tools/visual.d.ts +0 -40
- package/dist/tools/visual.js +0 -282
- package/dist/utils/http.d.ts +0 -6
- package/dist/utils/http.js +0 -151
- package/dist/utils/python-output.d.ts +0 -18
- package/dist/utils/python-output.js +0 -290
- package/dist/utils/python.d.ts +0 -2
- package/dist/utils/python.js +0 -4
- package/dist/utils/stdio-redirect.d.ts +0 -2
- package/dist/utils/stdio-redirect.js +0 -20
- package/docs/unreal-tool-test-cases.md +0 -574
- package/smithery.yaml +0 -29
- package/src/tools/build_environment_advanced.ts +0 -732
- package/src/tools/rc.ts +0 -515
- package/src/tools/visual.ts +0 -281
- package/src/utils/http.ts +0 -187
- package/src/utils/python-output.ts +0 -351
- package/src/utils/python.ts +0 -3
- package/src/utils/stdio-redirect.ts +0 -18
|
@@ -1,35 +1,35 @@
|
|
|
1
1
|
import { UnrealBridge } from '../unreal-bridge.js';
|
|
2
2
|
export declare class LevelResources {
|
|
3
|
-
private
|
|
3
|
+
private automationBridge;
|
|
4
4
|
constructor(bridge: UnrealBridge);
|
|
5
5
|
getCurrentLevel(): Promise<{
|
|
6
|
-
success: boolean;
|
|
7
|
-
name: string;
|
|
8
|
-
path: string;
|
|
9
|
-
error?: undefined;
|
|
10
|
-
} | {
|
|
11
6
|
success: boolean;
|
|
12
7
|
error: string;
|
|
13
8
|
name?: undefined;
|
|
14
9
|
path?: undefined;
|
|
15
|
-
}
|
|
16
|
-
getLevelName(): Promise<{
|
|
10
|
+
} | {
|
|
17
11
|
success: boolean;
|
|
12
|
+
name: string;
|
|
18
13
|
path: string;
|
|
19
14
|
error?: undefined;
|
|
20
|
-
}
|
|
15
|
+
}>;
|
|
16
|
+
getLevelName(): Promise<{
|
|
21
17
|
success: boolean;
|
|
22
18
|
error: string;
|
|
23
19
|
path?: undefined;
|
|
24
|
-
}
|
|
25
|
-
saveCurrentLevel(): Promise<{
|
|
20
|
+
} | {
|
|
26
21
|
success: boolean;
|
|
27
|
-
|
|
22
|
+
path: string;
|
|
28
23
|
error?: undefined;
|
|
29
|
-
}
|
|
24
|
+
}>;
|
|
25
|
+
saveCurrentLevel(): Promise<{
|
|
30
26
|
success: boolean;
|
|
31
27
|
error: string;
|
|
32
28
|
message?: undefined;
|
|
29
|
+
} | {
|
|
30
|
+
success: boolean;
|
|
31
|
+
message: string;
|
|
32
|
+
error?: undefined;
|
|
33
33
|
}>;
|
|
34
34
|
}
|
|
35
35
|
//# sourceMappingURL=levels.d.ts.map
|
package/dist/resources/levels.js
CHANGED
|
@@ -1,65 +1,56 @@
|
|
|
1
|
-
import { coerceString
|
|
1
|
+
import { coerceString } from '../utils/result-helpers.js';
|
|
2
2
|
export class LevelResources {
|
|
3
|
-
|
|
3
|
+
automationBridge;
|
|
4
4
|
constructor(bridge) {
|
|
5
|
-
this.
|
|
5
|
+
this.automationBridge = bridge.automationBridge;
|
|
6
6
|
}
|
|
7
7
|
async getCurrentLevel() {
|
|
8
|
-
// Use UnrealEditorSubsystem instead of deprecated EditorLevelLibrary
|
|
9
8
|
try {
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
});
|
|
16
|
-
if (interpreted.success) {
|
|
9
|
+
if (!this.automationBridge || typeof this.automationBridge.sendAutomationRequest !== 'function') {
|
|
10
|
+
return { success: false, error: 'Automation bridge is not available' };
|
|
11
|
+
}
|
|
12
|
+
const resp = await this.automationBridge.sendAutomationRequest('get_level', { action: 'get_current' });
|
|
13
|
+
if (resp && resp.success !== false && resp.result) {
|
|
17
14
|
return {
|
|
18
15
|
success: true,
|
|
19
|
-
name: coerceString(
|
|
20
|
-
path: coerceString(
|
|
16
|
+
name: coerceString(resp.result.name) ?? 'None',
|
|
17
|
+
path: coerceString(resp.result.path) ?? 'None'
|
|
21
18
|
};
|
|
22
19
|
}
|
|
23
|
-
return { success: false, error:
|
|
20
|
+
return { success: false, error: 'Failed to get current level' };
|
|
24
21
|
}
|
|
25
22
|
catch (err) {
|
|
26
23
|
return { error: `Failed to get current level: ${err}`, success: false };
|
|
27
24
|
}
|
|
28
25
|
}
|
|
29
26
|
async getLevelName() {
|
|
30
|
-
// Return camera/world info via Python first
|
|
31
27
|
try {
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
});
|
|
38
|
-
if (interpreted.success) {
|
|
28
|
+
if (!this.automationBridge || typeof this.automationBridge.sendAutomationRequest !== 'function') {
|
|
29
|
+
return { success: false, error: 'Automation bridge is not available' };
|
|
30
|
+
}
|
|
31
|
+
const resp = await this.automationBridge.sendAutomationRequest('get_level', { action: 'get_name' });
|
|
32
|
+
if (resp && resp.success !== false && resp.result) {
|
|
39
33
|
return {
|
|
40
34
|
success: true,
|
|
41
|
-
path: coerceString(
|
|
35
|
+
path: coerceString(resp.result.path) ?? ''
|
|
42
36
|
};
|
|
43
37
|
}
|
|
44
|
-
return { success: false, error:
|
|
38
|
+
return { success: false, error: 'Failed to get level name' };
|
|
45
39
|
}
|
|
46
40
|
catch (err) {
|
|
47
41
|
return { error: `Failed to get level name: ${err}`, success: false };
|
|
48
42
|
}
|
|
49
43
|
}
|
|
50
44
|
async saveCurrentLevel() {
|
|
51
|
-
// Strict modern API: require LevelEditorSubsystem
|
|
52
45
|
try {
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
if (interpreted.success) {
|
|
60
|
-
return { success: true, message: interpreted.message };
|
|
46
|
+
if (!this.automationBridge || typeof this.automationBridge.sendAutomationRequest !== 'function') {
|
|
47
|
+
return { success: false, error: 'Automation bridge is not available' };
|
|
48
|
+
}
|
|
49
|
+
const resp = await this.automationBridge.sendAutomationRequest('save_level', {});
|
|
50
|
+
if (resp && resp.success !== false) {
|
|
51
|
+
return { success: true, message: 'Level saved' };
|
|
61
52
|
}
|
|
62
|
-
return { success: false, error:
|
|
53
|
+
return { success: false, error: 'Failed to save level' };
|
|
63
54
|
}
|
|
64
55
|
catch (err) {
|
|
65
56
|
return { error: `Failed to save level: ${err}`, success: false };
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
|
|
2
|
+
import { UnrealBridge } from '../unreal-bridge.js';
|
|
3
|
+
import { AutomationBridge } from '../automation/index.js';
|
|
4
|
+
import { HealthMonitor } from '../services/health-monitor.js';
|
|
5
|
+
import { AssetResources } from '../resources/assets.js';
|
|
6
|
+
import { ActorResources } from '../resources/actors.js';
|
|
7
|
+
import { LevelResources } from '../resources/levels.js';
|
|
8
|
+
export declare class ResourceRegistry {
|
|
9
|
+
private server;
|
|
10
|
+
private bridge;
|
|
11
|
+
private automationBridge;
|
|
12
|
+
private assetResources;
|
|
13
|
+
private actorResources;
|
|
14
|
+
private levelResources;
|
|
15
|
+
private healthMonitor;
|
|
16
|
+
private ensureConnected;
|
|
17
|
+
constructor(server: Server, bridge: UnrealBridge, automationBridge: AutomationBridge, assetResources: AssetResources, actorResources: ActorResources, levelResources: LevelResources, healthMonitor: HealthMonitor, ensureConnected: () => Promise<boolean>);
|
|
18
|
+
register(): void;
|
|
19
|
+
}
|
|
20
|
+
//# sourceMappingURL=resource-registry.d.ts.map
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import { ListResourcesRequestSchema } from '@modelcontextprotocol/sdk/types.js';
|
|
2
|
+
import { ResourceHandler } from '../handlers/resource-handlers.js';
|
|
3
|
+
export class ResourceRegistry {
|
|
4
|
+
server;
|
|
5
|
+
bridge;
|
|
6
|
+
automationBridge;
|
|
7
|
+
assetResources;
|
|
8
|
+
actorResources;
|
|
9
|
+
levelResources;
|
|
10
|
+
healthMonitor;
|
|
11
|
+
ensureConnected;
|
|
12
|
+
constructor(server, bridge, automationBridge, assetResources, actorResources, levelResources, healthMonitor, ensureConnected) {
|
|
13
|
+
this.server = server;
|
|
14
|
+
this.bridge = bridge;
|
|
15
|
+
this.automationBridge = automationBridge;
|
|
16
|
+
this.assetResources = assetResources;
|
|
17
|
+
this.actorResources = actorResources;
|
|
18
|
+
this.levelResources = levelResources;
|
|
19
|
+
this.healthMonitor = healthMonitor;
|
|
20
|
+
this.ensureConnected = ensureConnected;
|
|
21
|
+
}
|
|
22
|
+
register() {
|
|
23
|
+
this.server.setRequestHandler(ListResourcesRequestSchema, async () => {
|
|
24
|
+
return {
|
|
25
|
+
resources: [
|
|
26
|
+
{ uri: 'ue://assets', name: 'Assets', description: 'Project assets', mimeType: 'application/json' },
|
|
27
|
+
{ uri: 'ue://health', name: 'Health Status', description: 'Server health and performance metrics', mimeType: 'application/json' },
|
|
28
|
+
{ uri: 'ue://automation-bridge', name: 'Automation Bridge', description: 'Automation bridge diagnostics and recent activity', mimeType: 'application/json' },
|
|
29
|
+
{ uri: 'ue://version', name: 'Engine Version', description: 'Unreal Engine version and compatibility info', mimeType: 'application/json' }
|
|
30
|
+
]
|
|
31
|
+
};
|
|
32
|
+
});
|
|
33
|
+
const resourceHandler = new ResourceHandler(this.server, this.bridge, this.automationBridge, this.assetResources, this.actorResources, this.levelResources, this.healthMonitor, this.ensureConnected);
|
|
34
|
+
resourceHandler.registerHandlers();
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
//# sourceMappingURL=resource-registry.js.map
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
|
|
2
|
+
import { UnrealBridge } from '../unreal-bridge.js';
|
|
3
|
+
import { AutomationBridge } from '../automation/index.js';
|
|
4
|
+
import { Logger } from '../utils/logger.js';
|
|
5
|
+
import { HealthMonitor } from '../services/health-monitor.js';
|
|
6
|
+
import { AssetResources } from '../resources/assets.js';
|
|
7
|
+
import { ActorResources } from '../resources/actors.js';
|
|
8
|
+
import { LevelResources } from '../resources/levels.js';
|
|
9
|
+
export declare class ToolRegistry {
|
|
10
|
+
private server;
|
|
11
|
+
private bridge;
|
|
12
|
+
private automationBridge;
|
|
13
|
+
private logger;
|
|
14
|
+
private healthMonitor;
|
|
15
|
+
private assetResources;
|
|
16
|
+
private actorResources;
|
|
17
|
+
private levelResources;
|
|
18
|
+
private ensureConnected;
|
|
19
|
+
private defaultElicitationTimeoutMs;
|
|
20
|
+
constructor(server: Server, bridge: UnrealBridge, automationBridge: AutomationBridge, logger: Logger, healthMonitor: HealthMonitor, assetResources: AssetResources, actorResources: ActorResources, levelResources: LevelResources, ensureConnected: () => Promise<boolean>);
|
|
21
|
+
register(): void;
|
|
22
|
+
}
|
|
23
|
+
//# sourceMappingURL=tool-registry.d.ts.map
|
|
@@ -0,0 +1,322 @@
|
|
|
1
|
+
import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
|
|
2
|
+
import { consolidatedToolDefinitions } from '../tools/consolidated-tool-definitions.js';
|
|
3
|
+
import { handleConsolidatedToolCall } from '../tools/consolidated-tool-handlers.js';
|
|
4
|
+
import { responseValidator } from '../utils/response-validator.js';
|
|
5
|
+
import { ErrorHandler } from '../utils/error-handler.js';
|
|
6
|
+
import { cleanObject } from '../utils/safe-json.js';
|
|
7
|
+
import { createElicitationHelper } from '../utils/elicitation.js';
|
|
8
|
+
import { ActorTools } from '../tools/actors.js';
|
|
9
|
+
import { AssetTools } from '../tools/assets.js';
|
|
10
|
+
import { EditorTools } from '../tools/editor.js';
|
|
11
|
+
import { MaterialTools } from '../tools/materials.js';
|
|
12
|
+
import { AnimationTools } from '../tools/animation.js';
|
|
13
|
+
import { PhysicsTools } from '../tools/physics.js';
|
|
14
|
+
import { NiagaraTools } from '../tools/niagara.js';
|
|
15
|
+
import { BlueprintTools } from '../tools/blueprint.js';
|
|
16
|
+
import { LevelTools } from '../tools/level.js';
|
|
17
|
+
import { LightingTools } from '../tools/lighting.js';
|
|
18
|
+
import { LandscapeTools } from '../tools/landscape.js';
|
|
19
|
+
import { FoliageTools } from '../tools/foliage.js';
|
|
20
|
+
import { EnvironmentTools } from '../tools/environment.js';
|
|
21
|
+
import { DebugVisualizationTools } from '../tools/debug.js';
|
|
22
|
+
import { PerformanceTools } from '../tools/performance.js';
|
|
23
|
+
import { AudioTools } from '../tools/audio.js';
|
|
24
|
+
import { UITools } from '../tools/ui.js';
|
|
25
|
+
import { SequenceTools } from '../tools/sequence.js';
|
|
26
|
+
import { IntrospectionTools } from '../tools/introspection.js';
|
|
27
|
+
import { EngineTools } from '../tools/engine.js';
|
|
28
|
+
import { BehaviorTreeTools } from '../tools/behavior-tree.js';
|
|
29
|
+
import { InputTools } from '../tools/input.js';
|
|
30
|
+
import { LogTools } from '../tools/logs.js';
|
|
31
|
+
import { getProjectSetting } from '../utils/ini-reader.js';
|
|
32
|
+
export class ToolRegistry {
|
|
33
|
+
server;
|
|
34
|
+
bridge;
|
|
35
|
+
automationBridge;
|
|
36
|
+
logger;
|
|
37
|
+
healthMonitor;
|
|
38
|
+
assetResources;
|
|
39
|
+
actorResources;
|
|
40
|
+
levelResources;
|
|
41
|
+
ensureConnected;
|
|
42
|
+
defaultElicitationTimeoutMs = 60000;
|
|
43
|
+
constructor(server, bridge, automationBridge, logger, healthMonitor, assetResources, actorResources, levelResources, ensureConnected) {
|
|
44
|
+
this.server = server;
|
|
45
|
+
this.bridge = bridge;
|
|
46
|
+
this.automationBridge = automationBridge;
|
|
47
|
+
this.logger = logger;
|
|
48
|
+
this.healthMonitor = healthMonitor;
|
|
49
|
+
this.assetResources = assetResources;
|
|
50
|
+
this.actorResources = actorResources;
|
|
51
|
+
this.levelResources = levelResources;
|
|
52
|
+
this.ensureConnected = ensureConnected;
|
|
53
|
+
}
|
|
54
|
+
register() {
|
|
55
|
+
const actorTools = new ActorTools(this.bridge);
|
|
56
|
+
const assetTools = new AssetTools(this.bridge);
|
|
57
|
+
const editorTools = new EditorTools(this.bridge);
|
|
58
|
+
const materialTools = new MaterialTools(this.bridge);
|
|
59
|
+
const animationTools = new AnimationTools(this.bridge);
|
|
60
|
+
const physicsTools = new PhysicsTools(this.bridge);
|
|
61
|
+
const niagaraTools = new NiagaraTools(this.bridge);
|
|
62
|
+
const blueprintTools = new BlueprintTools(this.bridge);
|
|
63
|
+
const levelTools = new LevelTools(this.bridge);
|
|
64
|
+
const lightingTools = new LightingTools(this.bridge);
|
|
65
|
+
const landscapeTools = new LandscapeTools(this.bridge);
|
|
66
|
+
const foliageTools = new FoliageTools(this.bridge);
|
|
67
|
+
const environmentTools = new EnvironmentTools(this.bridge);
|
|
68
|
+
const debugTools = new DebugVisualizationTools(this.bridge);
|
|
69
|
+
const performanceTools = new PerformanceTools(this.bridge);
|
|
70
|
+
const audioTools = new AudioTools(this.bridge);
|
|
71
|
+
const uiTools = new UITools(this.bridge);
|
|
72
|
+
const sequenceTools = new SequenceTools(this.bridge);
|
|
73
|
+
const introspectionTools = new IntrospectionTools(this.bridge);
|
|
74
|
+
const engineTools = new EngineTools(this.bridge);
|
|
75
|
+
const behaviorTreeTools = new BehaviorTreeTools(this.bridge);
|
|
76
|
+
const inputTools = new InputTools();
|
|
77
|
+
const logTools = new LogTools(this.bridge);
|
|
78
|
+
const toolsWithAutomation = [
|
|
79
|
+
materialTools, animationTools, physicsTools, niagaraTools,
|
|
80
|
+
lightingTools, landscapeTools, foliageTools, debugTools,
|
|
81
|
+
performanceTools, audioTools, uiTools, introspectionTools,
|
|
82
|
+
engineTools, environmentTools, inputTools
|
|
83
|
+
];
|
|
84
|
+
toolsWithAutomation.forEach(t => t.setAutomationBridge(this.automationBridge));
|
|
85
|
+
const systemTools = {
|
|
86
|
+
executeConsoleCommand: (command) => this.bridge.executeConsoleCommand(command),
|
|
87
|
+
getProjectSettings: async (section) => {
|
|
88
|
+
const category = typeof section === 'string' && section.trim().length > 0 ? section.trim() : 'Project';
|
|
89
|
+
if (!this.automationBridge || !this.automationBridge.isConnected()) {
|
|
90
|
+
if (process.env.UE_PROJECT_PATH) {
|
|
91
|
+
try {
|
|
92
|
+
const settings = await getProjectSetting(process.env.UE_PROJECT_PATH, category, '');
|
|
93
|
+
return {
|
|
94
|
+
success: true,
|
|
95
|
+
section: category,
|
|
96
|
+
settings: settings || {},
|
|
97
|
+
source: 'disk'
|
|
98
|
+
};
|
|
99
|
+
}
|
|
100
|
+
catch (_diskErr) {
|
|
101
|
+
return { success: false, error: 'Automation bridge not connected and disk read failed', section: category };
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
return { success: false, error: 'Automation bridge not connected', section: category };
|
|
105
|
+
}
|
|
106
|
+
try {
|
|
107
|
+
const resp = await this.automationBridge.sendAutomationRequest('system_control', {
|
|
108
|
+
action: 'get_project_settings',
|
|
109
|
+
category
|
|
110
|
+
}, { timeoutMs: 30000 });
|
|
111
|
+
const rawError = (resp?.error || '').toString();
|
|
112
|
+
const msgLower = (resp?.message || '').toString().toLowerCase();
|
|
113
|
+
const isNotImplemented = rawError.toUpperCase() === 'NOT_IMPLEMENTED' || msgLower.includes('not implemented');
|
|
114
|
+
if (!resp || resp.success === false) {
|
|
115
|
+
if (isNotImplemented) {
|
|
116
|
+
if (process.env.UE_PROJECT_PATH) {
|
|
117
|
+
try {
|
|
118
|
+
const settings = await getProjectSetting(process.env.UE_PROJECT_PATH, category, '');
|
|
119
|
+
return {
|
|
120
|
+
success: true,
|
|
121
|
+
section: category,
|
|
122
|
+
settings: settings || {},
|
|
123
|
+
source: 'disk'
|
|
124
|
+
};
|
|
125
|
+
}
|
|
126
|
+
catch (_diskErr) {
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
return {
|
|
130
|
+
success: true,
|
|
131
|
+
section: category,
|
|
132
|
+
settings: {
|
|
133
|
+
category,
|
|
134
|
+
available: false,
|
|
135
|
+
note: 'Project settings are not exposed by the current runtime but validation can proceed.'
|
|
136
|
+
}
|
|
137
|
+
};
|
|
138
|
+
}
|
|
139
|
+
return {
|
|
140
|
+
success: false,
|
|
141
|
+
error: rawError || resp?.message || 'Failed to get project settings',
|
|
142
|
+
section: category,
|
|
143
|
+
settings: resp?.result
|
|
144
|
+
};
|
|
145
|
+
}
|
|
146
|
+
const result = resp.result && typeof resp.result === 'object' ? resp.result : {};
|
|
147
|
+
const settings = (result.settings && typeof result.settings === 'object') ? result.settings : result;
|
|
148
|
+
return {
|
|
149
|
+
success: true,
|
|
150
|
+
section: category,
|
|
151
|
+
settings
|
|
152
|
+
};
|
|
153
|
+
}
|
|
154
|
+
catch (e) {
|
|
155
|
+
if (process.env.UE_PROJECT_PATH) {
|
|
156
|
+
try {
|
|
157
|
+
const settings = await getProjectSetting(process.env.UE_PROJECT_PATH, category, '');
|
|
158
|
+
return {
|
|
159
|
+
success: true,
|
|
160
|
+
section: category,
|
|
161
|
+
settings: settings || {},
|
|
162
|
+
source: 'disk'
|
|
163
|
+
};
|
|
164
|
+
}
|
|
165
|
+
catch (_diskErr) {
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
return {
|
|
169
|
+
success: false,
|
|
170
|
+
error: `Failed to get project settings: ${e instanceof Error ? e.message : String(e)}`,
|
|
171
|
+
section: category
|
|
172
|
+
};
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
};
|
|
176
|
+
const elicitation = createElicitationHelper(this.server, this.logger);
|
|
177
|
+
this.server.setRequestHandler(ListToolsRequestSchema, async () => {
|
|
178
|
+
this.logger.info('Serving consolidated tools');
|
|
179
|
+
const sanitized = consolidatedToolDefinitions.map((t) => {
|
|
180
|
+
try {
|
|
181
|
+
const copy = JSON.parse(JSON.stringify(t));
|
|
182
|
+
delete copy.outputSchema;
|
|
183
|
+
return copy;
|
|
184
|
+
}
|
|
185
|
+
catch (_e) {
|
|
186
|
+
return t;
|
|
187
|
+
}
|
|
188
|
+
});
|
|
189
|
+
return { tools: sanitized };
|
|
190
|
+
});
|
|
191
|
+
this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
|
|
192
|
+
const { name } = request.params;
|
|
193
|
+
let args = request.params.arguments || {};
|
|
194
|
+
const startTime = Date.now();
|
|
195
|
+
const connected = await this.ensureConnected();
|
|
196
|
+
if (!connected) {
|
|
197
|
+
if (name === 'system_control' && args.action === 'get_project_settings') {
|
|
198
|
+
}
|
|
199
|
+
else if (name === 'manage_pipeline') {
|
|
200
|
+
}
|
|
201
|
+
else {
|
|
202
|
+
this.healthMonitor.trackPerformance(startTime, false);
|
|
203
|
+
return {
|
|
204
|
+
content: [{ type: 'text', text: `Cannot execute tool '${name}': Unreal Engine is not connected.` }],
|
|
205
|
+
isError: true
|
|
206
|
+
};
|
|
207
|
+
}
|
|
208
|
+
}
|
|
209
|
+
const tools = {
|
|
210
|
+
actorTools, assetTools, materialTools, editorTools, animationTools,
|
|
211
|
+
physicsTools, niagaraTools, blueprintTools, levelTools, lightingTools,
|
|
212
|
+
landscapeTools, foliageTools, environmentTools, debugTools, performanceTools,
|
|
213
|
+
audioTools, systemTools, uiTools, sequenceTools, introspectionTools,
|
|
214
|
+
engineTools, behaviorTreeTools, inputTools, logTools,
|
|
215
|
+
elicit: elicitation.elicit,
|
|
216
|
+
supportsElicitation: elicitation.supports,
|
|
217
|
+
elicitationTimeoutMs: this.defaultElicitationTimeoutMs,
|
|
218
|
+
assetResources: this.assetResources,
|
|
219
|
+
actorResources: this.actorResources,
|
|
220
|
+
levelResources: this.levelResources,
|
|
221
|
+
bridge: this.bridge,
|
|
222
|
+
automationBridge: this.automationBridge
|
|
223
|
+
};
|
|
224
|
+
try {
|
|
225
|
+
this.logger.debug(`Executing tool: ${name}`);
|
|
226
|
+
try {
|
|
227
|
+
const toolDef = consolidatedToolDefinitions.find(t => t.name === name);
|
|
228
|
+
const inputSchema = toolDef?.inputSchema;
|
|
229
|
+
const elicitFn = tools.elicit;
|
|
230
|
+
if (inputSchema && typeof elicitFn === 'function') {
|
|
231
|
+
const props = inputSchema.properties || {};
|
|
232
|
+
const required = Array.isArray(inputSchema.required) ? inputSchema.required : [];
|
|
233
|
+
const missing = required.filter((k) => {
|
|
234
|
+
const v = args[k];
|
|
235
|
+
if (v === undefined || v === null)
|
|
236
|
+
return true;
|
|
237
|
+
if (typeof v === 'string' && v.trim() === '')
|
|
238
|
+
return true;
|
|
239
|
+
return false;
|
|
240
|
+
});
|
|
241
|
+
const primitiveProps = {};
|
|
242
|
+
for (const k of missing) {
|
|
243
|
+
const p = props[k];
|
|
244
|
+
if (!p || typeof p !== 'object')
|
|
245
|
+
continue;
|
|
246
|
+
const t = (p.type || '').toString();
|
|
247
|
+
const isEnum = Array.isArray(p.enum);
|
|
248
|
+
if (t === 'string' || t === 'number' || t === 'integer' || t === 'boolean' || isEnum) {
|
|
249
|
+
primitiveProps[k] = {
|
|
250
|
+
type: t || (isEnum ? 'string' : undefined),
|
|
251
|
+
title: p.title,
|
|
252
|
+
description: p.description,
|
|
253
|
+
enum: p.enum,
|
|
254
|
+
enumNames: p.enumNames,
|
|
255
|
+
minimum: p.minimum,
|
|
256
|
+
maximum: p.maximum,
|
|
257
|
+
minLength: p.minLength,
|
|
258
|
+
maxLength: p.maxLength,
|
|
259
|
+
pattern: p.pattern,
|
|
260
|
+
format: p.format,
|
|
261
|
+
default: p.default
|
|
262
|
+
};
|
|
263
|
+
}
|
|
264
|
+
}
|
|
265
|
+
if (Object.keys(primitiveProps).length > 0) {
|
|
266
|
+
const elicitOptions = { fallback: async () => ({ ok: false, error: 'missing-params' }) };
|
|
267
|
+
if (typeof tools.elicitationTimeoutMs === 'number' && Number.isFinite(tools.elicitationTimeoutMs)) {
|
|
268
|
+
elicitOptions.timeoutMs = tools.elicitationTimeoutMs;
|
|
269
|
+
}
|
|
270
|
+
const elicitRes = await elicitFn(`Provide missing parameters for ${name}`, { type: 'object', properties: primitiveProps, required: Object.keys(primitiveProps) }, elicitOptions);
|
|
271
|
+
if (elicitRes && elicitRes.ok && elicitRes.value) {
|
|
272
|
+
args = { ...args, ...elicitRes.value };
|
|
273
|
+
}
|
|
274
|
+
}
|
|
275
|
+
}
|
|
276
|
+
}
|
|
277
|
+
catch (e) {
|
|
278
|
+
this.logger.debug('Generic elicitation prefill skipped', { err: e?.message || String(e) });
|
|
279
|
+
}
|
|
280
|
+
let result = await handleConsolidatedToolCall(name, args, tools);
|
|
281
|
+
this.logger.debug(`Tool ${name} returned result`);
|
|
282
|
+
result = cleanObject(result);
|
|
283
|
+
const explicitSuccess = typeof result?.success === 'boolean' ? Boolean(result.success) : undefined;
|
|
284
|
+
const wrappedResult = await responseValidator.wrapResponse(name, result);
|
|
285
|
+
let wrappedSuccess = undefined;
|
|
286
|
+
try {
|
|
287
|
+
const sc = wrappedResult.structuredContent;
|
|
288
|
+
if (sc && typeof sc.success === 'boolean')
|
|
289
|
+
wrappedSuccess = Boolean(sc.success);
|
|
290
|
+
}
|
|
291
|
+
catch { }
|
|
292
|
+
const isErrorResponse = Boolean(wrappedResult?.isError === true);
|
|
293
|
+
const tentative = explicitSuccess ?? wrappedSuccess;
|
|
294
|
+
const finalSuccess = tentative === true && !isErrorResponse;
|
|
295
|
+
this.healthMonitor.trackPerformance(startTime, finalSuccess);
|
|
296
|
+
const durationMs = Date.now() - startTime;
|
|
297
|
+
if (finalSuccess) {
|
|
298
|
+
this.logger.info(`Tool ${name} completed successfully in ${durationMs}ms`);
|
|
299
|
+
}
|
|
300
|
+
else {
|
|
301
|
+
this.logger.warn(`Tool ${name} completed with errors in ${durationMs}ms`);
|
|
302
|
+
}
|
|
303
|
+
const responsePreview = JSON.stringify(wrappedResult).substring(0, 100);
|
|
304
|
+
this.logger.debug(`Returning response to MCP client: ${responsePreview}...`);
|
|
305
|
+
return wrappedResult;
|
|
306
|
+
}
|
|
307
|
+
catch (error) {
|
|
308
|
+
this.healthMonitor.trackPerformance(startTime, false);
|
|
309
|
+
const errorResponse = ErrorHandler.createErrorResponse(error, name, { ...args, scope: `tool-call/${name}` });
|
|
310
|
+
this.logger.error(`Tool execution failed: ${name}`, errorResponse);
|
|
311
|
+
this.healthMonitor.recordError(errorResponse);
|
|
312
|
+
const sanitizedError = cleanObject(errorResponse);
|
|
313
|
+
try {
|
|
314
|
+
sanitizedError.isError = true;
|
|
315
|
+
}
|
|
316
|
+
catch { }
|
|
317
|
+
return responseValidator.wrapResponse(name, sanitizedError);
|
|
318
|
+
}
|
|
319
|
+
});
|
|
320
|
+
}
|
|
321
|
+
}
|
|
322
|
+
//# sourceMappingURL=tool-registry.js.map
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
|
|
2
|
+
import { UnrealBridge } from './unreal-bridge.js';
|
|
3
|
+
import { AutomationBridge } from './automation/index.js';
|
|
4
|
+
import { Logger } from './utils/logger.js';
|
|
5
|
+
import { HealthMonitor } from './services/health-monitor.js';
|
|
6
|
+
export declare class ServerSetup {
|
|
7
|
+
private server;
|
|
8
|
+
private bridge;
|
|
9
|
+
private automationBridge;
|
|
10
|
+
private logger;
|
|
11
|
+
private healthMonitor;
|
|
12
|
+
private assetResources;
|
|
13
|
+
private actorResources;
|
|
14
|
+
private levelResources;
|
|
15
|
+
constructor(server: Server, bridge: UnrealBridge, automationBridge: AutomationBridge, logger: Logger, healthMonitor: HealthMonitor);
|
|
16
|
+
setup(): Promise<void>;
|
|
17
|
+
private validateEnvironment;
|
|
18
|
+
private ensureConnectedOnDemand;
|
|
19
|
+
private registerPrompts;
|
|
20
|
+
}
|
|
21
|
+
//# sourceMappingURL=server-setup.d.ts.map
|