blueprint-extractor-mcp 4.0.0 → 4.2.0

package/dist/helpers/subsystem.js

@@ -6,7 +6,10 @@ export async function callSubsystemJson(client, method, params, options) {
     }
     const parsed = JSON.parse(result);
     if (typeof parsed.error === 'string' && parsed.error.length > 0) {
-        const err = new Error(parsed.error);
+        const errorText = parsed.error === 'Unknown error'
+            ? `C++ subsystem returned generic "Unknown error" for ${method}(${Object.keys(params).join(', ')}). Check UE editor Output Log for the actual exception.`
+            : parsed.error;
+        const err = new Error(errorText);
         err.ueResponse = parsed;
         throw err;
     }

package/dist/server-config.js

@@ -70,8 +70,9 @@ export function classifyRecoverableToolFailure(toolName, message, payload) {
             recoverable: true,
             retry_after_ms: EDITOR_POLL_INTERVAL_MS,
             next_steps: [
-                'Call wait_for_editor to confirm the editor has fully reconnected after the restart window.',
-                'If the editor is connected but this persists, verify the BlueprintExtractor plugin/subsystem loaded successfully and retry the same tool.',
+                'Call wait_for_editor to confirm the editor has fully reconnected.',
+                'If a write operation (patch_class_defaults, modify_blueprint_members, etc.) was in progress, the editor may have crashed. Check the editor log and consider `git checkout` to recover modified assets.',
+                'Use restart_editor with force_kill: true if the editor process is unresponsive.',
             ],
         };
     }

package/dist/tools/blueprint-authoring.js

@@ -84,13 +84,27 @@ export function registerBlueprintAuthoringTools({ server, callSubsystemJson, jso
     }, async (args) => {
         try {
             const { asset_path, operation, payload, validate_only } = args;
+            const extraContent = [];
+            if (operation === 'patch_class_defaults' && payload?.classDefaults) {
+                const classDefaults = payload.classDefaults;
+                const warnings = [];
+                for (const [key, value] of Object.entries(classDefaults)) {
+                    if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+                        warnings.push(`Property '${key}': value is a nested object. If setting a component reference ` +
+                            `or asset path, use a string path (e.g., "/Game/Path/Asset.Asset") instead.`);
+                    }
+                }
+                if (warnings.length > 0) {
+                    extraContent.push({ type: 'text', text: `Warnings:\n${warnings.join('\n')}` });
+                }
+            }
             const parsed = await callSubsystemJson('ModifyBlueprintMembers', {
                 AssetPath: asset_path,
                 Operation: operation,
                 PayloadJson: JSON.stringify(payload ?? {}),
                 bValidateOnly: validate_only,
             });
-            return jsonToolSuccess(parsed);
+            return jsonToolSuccess(parsed, { extraContent });
         }
         catch (error) {
             return jsonToolError(error);

package/dist/tools/extraction.js

@@ -50,15 +50,14 @@ export function registerExtractionTools({ server, callSubsystemJson, scopeEnum,
                 parsed = compactBlueprint(parsed);
             }
             const text = compact ? JSON.stringify(parsed) : JSON.stringify(parsed, null, 2);
+            const extraContent = [];
             if (text.length > 200_000) {
-                return {
-                    content: [{
-                            type: 'text',
-                            text: `Warning: Response is ${(text.length / 1024).toFixed(0)}KB — consider using a narrower scope (ClassLevel, Variables, or FunctionsShallow).\n\n${text.substring(0, 200_000)}...\n[TRUNCATED]`,
-                        }],
-                };
+                extraContent.push({
+                    type: 'text',
+                    text: `Warning: Response is ${(text.length / 1024).toFixed(0)}KB (${text.length} chars). Consider using a narrower scope (ClassLevel, Variables, or FunctionsShallow) first, then Full with graph_filter for specific functions.`,
+                });
             }
-            return jsonToolSuccess(parsed);
+            return jsonToolSuccess(parsed, { extraContent });
         }
         catch (error) {
             return jsonToolError(error);
@@ -90,18 +89,17 @@ export function registerExtractionTools({ server, callSubsystemJson, scopeEnum,
                         break;
                 }
             }
+            const extraContent = [];
             if (asset_type === 'data_table') {
                 const text = JSON.stringify(parsed, null, 2);
                 if (text.length > 200_000) {
-                    return {
-                        content: [{
-                                type: 'text',
-                                text: `Warning: Response is ${(text.length / 1024).toFixed(0)}KB — large DataTable.\n\n${text.substring(0, 200_000)}...\n[TRUNCATED]`,
-                            }],
-                    };
+                    extraContent.push({
+                        type: 'text',
+                        text: `Warning: Response is ${(text.length / 1024).toFixed(0)}KB (${text.length} chars) — large DataTable. Consider filtering rows or extracting a subset.`,
+                    });
                 }
             }
-            return jsonToolSuccess(parsed);
+            return jsonToolSuccess(parsed, { extraContent });
         }
         catch (error) {
             return jsonToolError(error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blueprint-extractor-mcp",
-  "version": "4.0.0",
+  "version": "4.2.0",
   "description": "MCP server for the Unreal Engine BlueprintExtractor plugin over Remote Control",
   "type": "module",
   "main": "dist/index.js",