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.
- package/CHANGELOG.md +148 -9
- package/README.md +2 -2
- package/dist/gateway/gateway-manifest.generated.json +838 -133
- package/dist/proxy/native-proxy.js +6 -5
- package/dist/server/gateway/gateway-execute-dispatch.js +2 -1
- package/dist/server/gateway/gateway-execute-envelope.js +5 -1
- package/dist/server/gateway/gateway-execute-lookup.js +1 -1
- package/dist/server/gateway/gateway-execute.js +17 -4
- package/dist/server/gateway/gateway-schema-validate.js +13 -2
- package/dist/server/gateway/gateway-task-results.d.ts +6 -0
- package/dist/server/gateway/gateway-task-results.js +40 -0
- package/dist/server/tool-registry-manage-tools.js +4 -1
- package/dist/tools/catalog/capabilities/generated/canonical-registry.generated.d.ts +2 -2
- package/dist/tools/catalog/capabilities/generated/canonical-registry.generated.js +2 -2
- package/dist/tools/catalog/capabilities/generated/canonical-registry.generated.json +4079 -618
- package/dist/tools/catalog/capabilities/generated/capability-cost-index.generated.d.ts +1 -1
- package/dist/tools/catalog/capabilities/generated/capability-cost-index.generated.js +18 -1
- package/dist/tools/catalog/capabilities/generated/parent-tool-definitions.generated.js +1546 -212
- package/dist/tools/catalog/capabilities/records/aggregate.d.ts +1 -1
- package/dist/tools/catalog/capabilities/records/aggregate.js +1 -1
- package/dist/tools/catalog/capabilities/records/build-environment/spline.data.js +4 -3
- package/dist/tools/catalog/capabilities/records/build-environment/water.data.js +8 -5
- package/dist/tools/catalog/capabilities/records/control-actor/advanced-records.js +29 -8
- package/dist/tools/catalog/capabilities/records/control-actor/search-records.js +2 -2
- package/dist/tools/catalog/capabilities/records/control-actor/spawn-records.js +13 -5
- package/dist/tools/catalog/capabilities/records/control-actor/state-records.js +2 -1
- package/dist/tools/catalog/capabilities/records/control-actor/transform-records.js +27 -9
- package/dist/tools/catalog/capabilities/records/control-editor/asset.js +4 -1
- package/dist/tools/catalog/capabilities/records/control-editor/camera.js +5 -1
- package/dist/tools/catalog/capabilities/records/control-editor/command.js +5 -1
- package/dist/tools/catalog/capabilities/records/control-editor/input.js +2 -1
- package/dist/tools/catalog/capabilities/records/control-editor/screenshot.js +2 -1
- package/dist/tools/catalog/capabilities/records/control-editor/session.js +8 -1
- package/dist/tools/catalog/capabilities/records/control-editor/timing.js +5 -3
- package/dist/tools/catalog/capabilities/records/core/builder.d.ts +1 -0
- package/dist/tools/catalog/capabilities/records/core/builder.js +1 -0
- package/dist/tools/catalog/capabilities/records/folds/build-environment.folds.js +2 -2
- package/dist/tools/catalog/capabilities/records/folds/control-actor.folds.js +2 -2
- package/dist/tools/catalog/capabilities/records/folds/manage-asset.folds.js +8 -8
- package/dist/tools/catalog/capabilities/records/folds/manage-audio.folds.js +5 -5
- package/dist/tools/catalog/capabilities/records/folds/manage-blueprint.folds.js +2 -2
- package/dist/tools/catalog/capabilities/records/folds/manage-effect.folds.js +3 -3
- package/dist/tools/catalog/capabilities/records/folds/manage-sequence.folds.js +6 -6
- package/dist/tools/catalog/capabilities/records/folds/system-control.folds.js +2 -2
- package/dist/tools/catalog/capabilities/records/gameplay/animation-physics/animation-properties.js +7 -5
- package/dist/tools/catalog/capabilities/records/gameplay/animation-physics/authoring-1.data.js +86 -1
- package/dist/tools/catalog/capabilities/records/gameplay/animation-physics/authoring-2.data.js +7 -2
- package/dist/tools/catalog/capabilities/records/gameplay/manage-effect/effect-properties.js +7 -6
- package/dist/tools/catalog/capabilities/records/gameplay/manage-effect/effect.data.js +38 -27
- package/dist/tools/catalog/capabilities/records/inspect/component-actor.data.js +1 -1
- package/dist/tools/catalog/capabilities/records/inspect/object-property.data.js +188 -10
- package/dist/tools/catalog/capabilities/records/inspect/properties.d.ts +1 -0
- package/dist/tools/catalog/capabilities/records/inspect/properties.js +2 -1
- package/dist/tools/catalog/capabilities/records/inspect/runtime.data.js +2 -1
- package/dist/tools/catalog/capabilities/records/inspect/stats.data.js +6 -2
- package/dist/tools/catalog/capabilities/records/manage-asset/asset-advanced.js +46 -0
- package/dist/tools/catalog/capabilities/records/manage-asset/asset-lifecycle.js +2 -2
- package/dist/tools/catalog/capabilities/records/manage-asset/asset-query.js +4 -3
- package/dist/tools/catalog/capabilities/records/manage-asset/builder.d.ts +3 -0
- package/dist/tools/catalog/capabilities/records/manage-asset/builder.js +3 -0
- package/dist/tools/catalog/capabilities/records/manage-asset/content-sources.js +3 -1
- package/dist/tools/catalog/capabilities/records/manage-asset/material-create.js +17 -2
- package/dist/tools/catalog/capabilities/records/manage-asset/material-graph.js +7 -5
- package/dist/tools/catalog/capabilities/records/manage-asset/material-params.js +5 -5
- package/dist/tools/catalog/capabilities/records/manage-audio/authoring.data.js +15 -5
- package/dist/tools/catalog/capabilities/records/manage-audio/runtime.data.js +1 -0
- package/dist/tools/catalog/capabilities/records/manage-blueprint/functions-events.js +3 -2
- package/dist/tools/catalog/capabilities/records/manage-blueprint/graph-batch.js +2 -2
- package/dist/tools/catalog/capabilities/records/manage-blueprint/graph-pins.js +6 -2
- package/dist/tools/catalog/capabilities/records/manage-blueprint/properties.js +4 -2
- package/dist/tools/catalog/capabilities/records/manage-blueprint/scs-components.js +7 -2
- package/dist/tools/catalog/capabilities/records/manage-blueprint/variables-metadata.js +8 -2
- package/dist/tools/catalog/capabilities/records/manage-blueprint/widget-animation.js +14 -4
- package/dist/tools/catalog/capabilities/records/manage-blueprint/widget-lifecycle.js +13 -5
- package/dist/tools/catalog/capabilities/records/manage-blueprint/widget-panels.js +1 -1
- package/dist/tools/catalog/capabilities/records/manage-sequence/cinematic.js +12 -3
- package/dist/tools/catalog/capabilities/records/manage-sequence/helpers.js +2 -2
- package/dist/tools/catalog/capabilities/records/manage-sequence/mrq.js +23 -4
- package/dist/tools/catalog/capabilities/records/manage-sequence/timeline-bindings.js +2 -2
- package/dist/tools/catalog/capabilities/records/manage-sequence/timeline-lifecycle.js +7 -2
- package/dist/tools/catalog/capabilities/records/manage-sequence/timeline-playback.js +9 -5
- package/dist/tools/catalog/capabilities/records/manage-sequence/timeline-state-ranges.js +19 -0
- package/dist/tools/catalog/capabilities/records/manage-sequence/timeline-tracks.js +10 -5
- package/dist/tools/catalog/capabilities/records/manage-tools/index.js +30 -2
- package/dist/tools/catalog/capabilities/records/system-control/console.js +3 -1
- package/dist/tools/catalog/capabilities/records/system-control/system-ops.js +122 -10
- package/dist/tools/catalog/capabilities/records/utility/output-glossary.js +11 -0
- package/dist/tools/catalog/capabilities/records/utility/utility-schema-pins.js +6 -3
- package/dist/tools/catalog/capabilities/records/world/manage-geometry.optimize.data.js +29 -0
- package/dist/tools/catalog/capabilities/records/world/manage-geometry.primitives.data.js +2 -1
- package/dist/tools/catalog/capabilities/records/world/properties.js +2 -2
- package/dist/tools/catalog/capabilities/semantic/envelope.d.ts +1 -1
- package/dist/tools/catalog/capabilities/semantic/errors.d.ts +1 -1
- package/dist/tools/catalog/unreal-gateway-definition.js +2 -2
- package/dist/utils/responses/gateway-reply-compaction.d.ts +6 -0
- package/dist/utils/responses/gateway-reply-compaction.js +264 -0
- package/dist/utils/responses/response-content.d.ts +0 -1
- package/dist/utils/responses/response-content.js +0 -172
- package/dist/utils/responses/response-validator.d.ts +1 -1
- package/dist/utils/responses/response-validator.js +39 -8
- package/package.json +2 -2
- package/server.json +2 -2
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export declare function wrapGatewayResponse(
|
|
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,
|
|
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(
|
|
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
|
|
15
|
-
|
|
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 =
|
|
21
|
-
if (
|
|
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-
|
|
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.
|
|
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-
|
|
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-
|
|
11
|
+
"version": "0.6.0-beta-e",
|
|
12
12
|
"transport": {
|
|
13
13
|
"type": "stdio"
|
|
14
14
|
},
|