unreal-engine-mcp-server 0.6.0-beta-c → 0.6.0-beta-e

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.
Files changed (102) hide show
  1. package/CHANGELOG.md +148 -9
  2. package/README.md +2 -2
  3. package/dist/gateway/gateway-manifest.generated.json +838 -133
  4. package/dist/proxy/native-proxy.js +6 -5
  5. package/dist/server/gateway/gateway-execute-dispatch.js +2 -1
  6. package/dist/server/gateway/gateway-execute-envelope.js +5 -1
  7. package/dist/server/gateway/gateway-execute-lookup.js +1 -1
  8. package/dist/server/gateway/gateway-execute.js +17 -4
  9. package/dist/server/gateway/gateway-schema-validate.js +13 -2
  10. package/dist/server/gateway/gateway-task-results.d.ts +6 -0
  11. package/dist/server/gateway/gateway-task-results.js +40 -0
  12. package/dist/server/tool-registry-manage-tools.js +4 -1
  13. package/dist/tools/catalog/capabilities/generated/canonical-registry.generated.d.ts +2 -2
  14. package/dist/tools/catalog/capabilities/generated/canonical-registry.generated.js +2 -2
  15. package/dist/tools/catalog/capabilities/generated/canonical-registry.generated.json +4079 -618
  16. package/dist/tools/catalog/capabilities/generated/capability-cost-index.generated.d.ts +1 -1
  17. package/dist/tools/catalog/capabilities/generated/capability-cost-index.generated.js +18 -1
  18. package/dist/tools/catalog/capabilities/generated/parent-tool-definitions.generated.js +1546 -212
  19. package/dist/tools/catalog/capabilities/records/aggregate.d.ts +1 -1
  20. package/dist/tools/catalog/capabilities/records/aggregate.js +1 -1
  21. package/dist/tools/catalog/capabilities/records/build-environment/spline.data.js +4 -3
  22. package/dist/tools/catalog/capabilities/records/build-environment/water.data.js +8 -5
  23. package/dist/tools/catalog/capabilities/records/control-actor/advanced-records.js +29 -8
  24. package/dist/tools/catalog/capabilities/records/control-actor/search-records.js +2 -2
  25. package/dist/tools/catalog/capabilities/records/control-actor/spawn-records.js +13 -5
  26. package/dist/tools/catalog/capabilities/records/control-actor/state-records.js +2 -1
  27. package/dist/tools/catalog/capabilities/records/control-actor/transform-records.js +27 -9
  28. package/dist/tools/catalog/capabilities/records/control-editor/asset.js +4 -1
  29. package/dist/tools/catalog/capabilities/records/control-editor/camera.js +5 -1
  30. package/dist/tools/catalog/capabilities/records/control-editor/command.js +5 -1
  31. package/dist/tools/catalog/capabilities/records/control-editor/input.js +2 -1
  32. package/dist/tools/catalog/capabilities/records/control-editor/screenshot.js +2 -1
  33. package/dist/tools/catalog/capabilities/records/control-editor/session.js +8 -1
  34. package/dist/tools/catalog/capabilities/records/control-editor/timing.js +5 -3
  35. package/dist/tools/catalog/capabilities/records/core/builder.d.ts +1 -0
  36. package/dist/tools/catalog/capabilities/records/core/builder.js +1 -0
  37. package/dist/tools/catalog/capabilities/records/folds/build-environment.folds.js +2 -2
  38. package/dist/tools/catalog/capabilities/records/folds/control-actor.folds.js +2 -2
  39. package/dist/tools/catalog/capabilities/records/folds/manage-asset.folds.js +8 -8
  40. package/dist/tools/catalog/capabilities/records/folds/manage-audio.folds.js +5 -5
  41. package/dist/tools/catalog/capabilities/records/folds/manage-blueprint.folds.js +2 -2
  42. package/dist/tools/catalog/capabilities/records/folds/manage-effect.folds.js +3 -3
  43. package/dist/tools/catalog/capabilities/records/folds/manage-sequence.folds.js +6 -6
  44. package/dist/tools/catalog/capabilities/records/folds/system-control.folds.js +2 -2
  45. package/dist/tools/catalog/capabilities/records/gameplay/animation-physics/animation-properties.js +7 -5
  46. package/dist/tools/catalog/capabilities/records/gameplay/animation-physics/authoring-1.data.js +86 -1
  47. package/dist/tools/catalog/capabilities/records/gameplay/animation-physics/authoring-2.data.js +7 -2
  48. package/dist/tools/catalog/capabilities/records/gameplay/manage-effect/effect-properties.js +7 -6
  49. package/dist/tools/catalog/capabilities/records/gameplay/manage-effect/effect.data.js +38 -27
  50. package/dist/tools/catalog/capabilities/records/inspect/component-actor.data.js +1 -1
  51. package/dist/tools/catalog/capabilities/records/inspect/object-property.data.js +188 -10
  52. package/dist/tools/catalog/capabilities/records/inspect/properties.d.ts +1 -0
  53. package/dist/tools/catalog/capabilities/records/inspect/properties.js +2 -1
  54. package/dist/tools/catalog/capabilities/records/inspect/runtime.data.js +2 -1
  55. package/dist/tools/catalog/capabilities/records/inspect/stats.data.js +6 -2
  56. package/dist/tools/catalog/capabilities/records/manage-asset/asset-advanced.js +46 -0
  57. package/dist/tools/catalog/capabilities/records/manage-asset/asset-lifecycle.js +2 -2
  58. package/dist/tools/catalog/capabilities/records/manage-asset/asset-query.js +4 -3
  59. package/dist/tools/catalog/capabilities/records/manage-asset/builder.d.ts +3 -0
  60. package/dist/tools/catalog/capabilities/records/manage-asset/builder.js +3 -0
  61. package/dist/tools/catalog/capabilities/records/manage-asset/content-sources.js +3 -1
  62. package/dist/tools/catalog/capabilities/records/manage-asset/material-create.js +17 -2
  63. package/dist/tools/catalog/capabilities/records/manage-asset/material-graph.js +7 -5
  64. package/dist/tools/catalog/capabilities/records/manage-asset/material-params.js +5 -5
  65. package/dist/tools/catalog/capabilities/records/manage-audio/authoring.data.js +15 -5
  66. package/dist/tools/catalog/capabilities/records/manage-audio/runtime.data.js +1 -0
  67. package/dist/tools/catalog/capabilities/records/manage-blueprint/functions-events.js +3 -2
  68. package/dist/tools/catalog/capabilities/records/manage-blueprint/graph-batch.js +2 -2
  69. package/dist/tools/catalog/capabilities/records/manage-blueprint/graph-pins.js +6 -2
  70. package/dist/tools/catalog/capabilities/records/manage-blueprint/properties.js +4 -2
  71. package/dist/tools/catalog/capabilities/records/manage-blueprint/scs-components.js +7 -2
  72. package/dist/tools/catalog/capabilities/records/manage-blueprint/variables-metadata.js +8 -2
  73. package/dist/tools/catalog/capabilities/records/manage-blueprint/widget-animation.js +14 -4
  74. package/dist/tools/catalog/capabilities/records/manage-blueprint/widget-lifecycle.js +13 -5
  75. package/dist/tools/catalog/capabilities/records/manage-blueprint/widget-panels.js +1 -1
  76. package/dist/tools/catalog/capabilities/records/manage-sequence/cinematic.js +12 -3
  77. package/dist/tools/catalog/capabilities/records/manage-sequence/helpers.js +2 -2
  78. package/dist/tools/catalog/capabilities/records/manage-sequence/mrq.js +23 -4
  79. package/dist/tools/catalog/capabilities/records/manage-sequence/timeline-bindings.js +2 -2
  80. package/dist/tools/catalog/capabilities/records/manage-sequence/timeline-lifecycle.js +7 -2
  81. package/dist/tools/catalog/capabilities/records/manage-sequence/timeline-playback.js +9 -5
  82. package/dist/tools/catalog/capabilities/records/manage-sequence/timeline-state-ranges.js +19 -0
  83. package/dist/tools/catalog/capabilities/records/manage-sequence/timeline-tracks.js +10 -5
  84. package/dist/tools/catalog/capabilities/records/manage-tools/index.js +30 -2
  85. package/dist/tools/catalog/capabilities/records/system-control/console.js +3 -1
  86. package/dist/tools/catalog/capabilities/records/system-control/system-ops.js +122 -10
  87. package/dist/tools/catalog/capabilities/records/utility/output-glossary.js +11 -0
  88. package/dist/tools/catalog/capabilities/records/utility/utility-schema-pins.js +6 -3
  89. package/dist/tools/catalog/capabilities/records/world/manage-geometry.optimize.data.js +29 -0
  90. package/dist/tools/catalog/capabilities/records/world/manage-geometry.primitives.data.js +2 -1
  91. package/dist/tools/catalog/capabilities/records/world/properties.js +2 -2
  92. package/dist/tools/catalog/capabilities/semantic/envelope.d.ts +1 -1
  93. package/dist/tools/catalog/capabilities/semantic/errors.d.ts +1 -1
  94. package/dist/tools/catalog/unreal-gateway-definition.js +2 -2
  95. package/dist/utils/responses/gateway-reply-compaction.d.ts +6 -0
  96. package/dist/utils/responses/gateway-reply-compaction.js +264 -0
  97. package/dist/utils/responses/response-content.d.ts +0 -1
  98. package/dist/utils/responses/response-content.js +0 -172
  99. package/dist/utils/responses/response-validator.d.ts +1 -1
  100. package/dist/utils/responses/response-validator.js +39 -8
  101. package/package.json +2 -2
  102. package/server.json +2 -2
@@ -1,2 +1,2 @@
1
- export declare function wrapGatewayResponse(response: unknown): Record<string, unknown>;
1
+ export declare function wrapGatewayResponse(fullResponse: unknown): Record<string, unknown>;
2
2
  //# sourceMappingURL=response-validator.d.ts.map
@@ -1,30 +1,61 @@
1
1
  import { Logger } from '../logging/logger.js';
2
- import { buildImageContent, buildSummaryText, hasExplicitFailurePayload } from './response-content.js';
2
+ import { buildImageContent, hasExplicitFailurePayload } from './response-content.js';
3
+ import { compactGatewayReply } from './gateway-reply-compaction.js';
3
4
  import { cleanObject } from '../serialization/safe-json.js';
4
5
  import { isRecord } from '../validation/type-guards.js';
5
6
  import { validateAgainstCapabilitySchema } from '../../server/gateway/gateway-schema-validate.js';
6
7
  import { unrealGatewayToolDefinition } from '../../tools/catalog/unreal-gateway-definition.js';
7
8
  const log = new Logger('ResponseValidator');
8
- export function wrapGatewayResponse(response) {
9
+ export function wrapGatewayResponse(fullResponse) {
10
+ const response = compactGatewayReply(fullResponse);
9
11
  const schema = unrealGatewayToolDefinition.outputSchema;
10
12
  const violation = schema === undefined ? undefined : validateAgainstCapabilitySchema(response, schema);
11
13
  const errors = violation === undefined ? undefined : [`${violation.pointer || 'root'}: ${violation.message}`];
12
14
  if (errors !== undefined)
13
15
  log.warn('Response validation failed for unreal:', errors);
14
- const wrapped = {
15
- content: [{ type: 'text', text: buildSummaryText('unreal', response) }]
16
- };
16
+ const structured = typeof response === 'object' && response !== null ? cleanObject(response) : response;
17
+ const imageContent = buildImageContent(structured);
18
+ const shown = imageContent ? omitImagePayload(structured, 0) : structured;
19
+ const failed = hasExplicitFailurePayload(shown) || (isRecord(response) && response.success === false);
20
+ const wrapped = { content: [{ type: 'text', text: replyText(shown, failed) }] };
17
21
  if (isRecord(response) && typeof response.success === 'boolean')
18
22
  wrapped.success = response.success;
19
23
  if (response !== undefined)
20
- wrapped.structuredContent = typeof response === 'object' && response !== null ? cleanObject(response) : response;
21
- if (hasExplicitFailurePayload(wrapped.structuredContent) || wrapped.success === false)
24
+ wrapped.structuredContent = shown;
25
+ if (failed)
22
26
  wrapped.isError = true;
23
27
  if (errors !== undefined)
24
28
  wrapped._validation = { valid: false, errors };
25
- const imageContent = buildImageContent(wrapped.structuredContent);
26
29
  if (imageContent)
27
30
  wrapped.content.push(imageContent);
28
31
  return wrapped;
29
32
  }
33
+ function replyText(reply, failed) {
34
+ if (!isRecord(reply))
35
+ return typeof reply === 'string' && reply.trim() !== '' ? reply : 'unreal responded';
36
+ const message = typeof reply.message === 'string' && reply.message !== '' ? reply.message : failed ? 'execute failed' : 'ok';
37
+ const code = typeof reply.errorCode === 'string' && reply.errorCode !== '' ? reply.errorCode : undefined;
38
+ const line = !failed ? message : code === undefined ? `Error: ${message}` : `Error [${code}]: ${message}`;
39
+ const body = { ...reply };
40
+ if (body.message === message)
41
+ delete body.message;
42
+ if (failed && code !== undefined)
43
+ delete body.errorCode;
44
+ return `${line}\n\n${JSON.stringify(body)}`;
45
+ }
46
+ const IMAGE_PLACEHOLDER = '<omitted; see image content>';
47
+ const MAX_IMAGE_DEPTH = 100;
48
+ function omitImagePayload(value, depth) {
49
+ if (depth > MAX_IMAGE_DEPTH)
50
+ return value;
51
+ if (Array.isArray(value))
52
+ return value.map((item) => omitImagePayload(item, depth + 1));
53
+ if (!isRecord(value))
54
+ return value;
55
+ const out = {};
56
+ for (const [key, child] of Object.entries(value)) {
57
+ out[key] = key === 'imageBase64' && typeof child === 'string' ? IMAGE_PLACEHOLDER : omitImagePayload(child, depth + 1);
58
+ }
59
+ return out;
60
+ }
30
61
  //# sourceMappingURL=response-validator.js.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "unreal-engine-mcp-server",
3
- "version": "0.6.0-beta-c",
3
+ "version": "0.6.0-beta-e",
4
4
  "mcpName": "io.github.ChiR24/unreal-engine-mcp",
5
5
  "description": "A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal Engine via native automation bridge. Built with TypeScript and designed for game development automation.",
6
6
  "type": "module",
@@ -66,7 +66,7 @@
66
66
  "author": "Unreal Engine MCP Team",
67
67
  "license": "MIT",
68
68
  "dependencies": {
69
- "@modelcontextprotocol/sdk": "1.29.0",
69
+ "@modelcontextprotocol/sdk": "1.32.1",
70
70
  "ws": "^8.18.3",
71
71
  "zod": "^4.2.1"
72
72
  },
package/server.json CHANGED
@@ -2,13 +2,13 @@
2
2
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
3
  "name": "io.github.ChiR24/unreal-engine-mcp",
4
4
  "description": "Automate the Unreal Editor (UE 5.0-5.8): levels, Blueprints, UI, materials, VFX and more.",
5
- "version": "0.6.0-beta-c",
5
+ "version": "0.6.0-beta-e",
6
6
  "packages": [
7
7
  {
8
8
  "registryType": "npm",
9
9
  "registryBaseUrl": "https://registry.npmjs.org",
10
10
  "identifier": "unreal-engine-mcp-server",
11
- "version": "0.6.0-beta-c",
11
+ "version": "0.6.0-beta-e",
12
12
  "transport": {
13
13
  "type": "stdio"
14
14
  },