blueprint-extractor-mcp 1.3.0 → 1.4.0

package/dist/compactor.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Compacts Blueprint extraction JSON by stripping low-value fields and minifying.
+ * Reduces size by ~50-70% for LLM consumption.
+ */
+/**
+ * Compacts a parsed Blueprint extraction result.
+ * - Removes positional data (posX, posY), GUIDs, empty fields
+ * - Replaces nodeGuid with sequential short IDs (n0, n1, ...)
+ * - Rewrites connection references to use short IDs
+ * - Replaces exec pin type objects with the string "exec"
+ */
+export declare function compactBlueprint(data: unknown): unknown;

package/dist/compactor.js

@@ -0,0 +1,100 @@
+/**
+ * Compacts Blueprint extraction JSON by stripping low-value fields and minifying.
+ * Reduces size by ~50-70% for LLM consumption.
+ */
+/**
+ * Compacts a parsed Blueprint extraction result.
+ * - Removes positional data (posX, posY), GUIDs, empty fields
+ * - Replaces nodeGuid with sequential short IDs (n0, n1, ...)
+ * - Rewrites connection references to use short IDs
+ * - Replaces exec pin type objects with the string "exec"
+ */
+export function compactBlueprint(data) {
+    if (!data || typeof data !== 'object')
+        return data;
+    const root = data;
+    const bp = root.blueprint;
+    if (!bp)
+        return data;
+    const functions = bp.functions;
+    if (!Array.isArray(functions))
+        return data;
+    for (const graph of functions) {
+        compactGraph(graph);
+    }
+    return data;
+}
+function compactGraph(graph) {
+    // Remove graphGuid at graph level
+    delete graph.graphGuid;
+    const nodes = graph.nodes;
+    if (!Array.isArray(nodes))
+        return;
+    // Build guidToShortId map
+    const guidToShortId = new Map();
+    for (let i = 0; i < nodes.length; i++) {
+        const guid = nodes[i].nodeGuid;
+        if (guid) {
+            guidToShortId.set(guid, `n${i}`);
+        }
+    }
+    // Process each node
+    for (let i = 0; i < nodes.length; i++) {
+        const node = nodes[i];
+        // Replace nodeGuid with short ID
+        delete node.nodeGuid;
+        node.id = `n${i}`;
+        // Remove positional data
+        delete node.posX;
+        delete node.posY;
+        // Remove empty nodeComment
+        if (node.nodeComment === '') {
+            delete node.nodeComment;
+        }
+        // Process pins
+        const pins = node.pins;
+        if (Array.isArray(pins)) {
+            for (const pin of pins) {
+                compactPin(pin, guidToShortId);
+            }
+        }
+    }
+}
+function compactPin(pin, guidToShortId) {
+    // Remove pinId
+    delete pin.pinId;
+    // Remove autogeneratedDefaultValue
+    delete pin.autogeneratedDefaultValue;
+    // Remove empty defaultValue
+    if (pin.defaultValue === '') {
+        delete pin.defaultValue;
+    }
+    // Process type object
+    const type = pin.type;
+    if (type && typeof type === 'object') {
+        // Remove empty sub_category
+        if (type.sub_category === '') {
+            delete type.sub_category;
+        }
+        // Replace exec pin type with string "exec"
+        if (type.category === 'exec') {
+            pin.type = 'exec';
+        }
+    }
+    // Rewrite connection nodeGuid references to short IDs
+    const connections = pin.connections;
+    if (Array.isArray(connections)) {
+        if (connections.length === 0) {
+            // Remove empty connections arrays
+            delete pin.connections;
+        }
+        else {
+            for (const conn of connections) {
+                const connGuid = conn.nodeGuid;
+                if (connGuid && guidToShortId.has(connGuid)) {
+                    conn.nodeGuid = guidToShortId.get(connGuid);
+                }
+            }
+        }
+    }
+}

package/dist/index.js

@@ -3,10 +3,11 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
 import { UEClient } from './ue-client.js';
+import { compactBlueprint } from './compactor.js';
 const client = new UEClient();
 const server = new McpServer({
     name: 'blueprint-extractor',
-    version: '1.3.0',
+    version: '1.4.0',
 });
 // Shared scope enum with detailed descriptions
 const scopeEnum = z.enum([
@@ -62,11 +63,15 @@ USAGE GUIDELINES:
   * FullWithBytecode — + raw bytecode hex dump (largest, rarely needed)
 - Only escalate to Full when you need to understand graph logic (node connections, pin values, execution flow).
 - Full scope on complex Blueprints can exceed 200KB and will be truncated. If truncated, use a narrower scope or inspect specific functions via the graph names from FunctionsShallow.
+- Use FunctionsShallow scope first to get graph names, then request specific graphs with graph_filter to reduce output size.
+- Use compact=true to reduce JSON size by ~50-70% for LLM consumption.
 
 RETURNS: JSON object with the extracted Blueprint data at the requested scope level.`,
     inputSchema: {
         asset_path: z.string().describe('UE content path to the Blueprint asset. Must start with /Game/ (e.g. /Game/Blueprints/BP_Character). Use search_assets to find paths.'),
         scope: scopeEnum.default('Variables').describe('Extraction depth. Start with ClassLevel or Variables — only use Full when you need graph/node details.'),
+        graph_filter: z.array(z.string()).optional().describe('Filter to specific graphs by name. Use FunctionsShallow scope first to discover graph names, then pass the names you want here. Empty/omitted = extract all graphs. Example: ["EventGraph", "CalculateDamage"]'),
+        compact: z.boolean().default(false).describe('When true, strips low-value fields and minifies JSON to reduce size by ~50-70%. Removes: pinId, posX/posY, graphGuid, autogeneratedDefaultValue, nodeComment (when empty), empty connections, empty default_value, empty sub_category. Replaces full exec pin type objects with the string "exec".'),
     },
     annotations: {
         title: 'Extract Blueprint',
@@ -75,14 +80,21 @@ RETURNS: JSON object with the extracted Blueprint data at the requested scope le
         idempotentHint: true,
         openWorldHint: false,
     },
-}, async ({ asset_path, scope }) => {
+}, async ({ asset_path, scope, graph_filter, compact }) => {
     try {
-        const result = await client.callSubsystem('ExtractBlueprint', { AssetPath: asset_path, Scope: scope });
-        const parsed = JSON.parse(result);
+        const result = await client.callSubsystem('ExtractBlueprint', {
+            AssetPath: asset_path,
+            Scope: scope,
+            GraphFilter: graph_filter ? graph_filter.join(',') : '',
+        });
+        let parsed = JSON.parse(result);
         if (parsed.error) {
             return { content: [{ type: 'text', text: `Error: ${parsed.error}` }], isError: true };
         }
-        const text = JSON.stringify(parsed, null, 2);
+        if (compact) {
+            parsed = compactBlueprint(parsed);
+        }
+        const text = compact ? JSON.stringify(parsed) : JSON.stringify(parsed, null, 2);
         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]` }] };
         }
@@ -214,6 +226,8 @@ RETURNS: Summary with extracted_count and output_directory path. Read the output
         asset_paths: z.array(z.string()).describe('Array of UE content paths to extract (e.g. ["/Game/Blueprints/BP_Character", "/Game/Blueprints/BP_Weapon"])'),
         scope: scopeEnum.default('Full').describe('Extraction depth applied to all assets. Full is the default since cascade is typically used for deep analysis.'),
         max_depth: z.number().int().min(0).max(10).default(3).describe('How many levels deep to follow references (0 = only the listed assets, 3 = default)'),
+        graph_filter: z.array(z.string()).optional().describe('Filter to specific graphs by name. Use FunctionsShallow scope first to discover graph names, then pass the names you want here. Empty/omitted = extract all graphs. Example: ["EventGraph", "CalculateDamage"]'),
+        compact: z.boolean().default(false).describe('When true, strips low-value fields and minifies JSON to reduce size by ~50-70%. Removes: pinId, posX/posY, graphGuid, autogeneratedDefaultValue, nodeComment (when empty), empty connections, empty default_value, empty sub_category. Replaces full exec pin type objects with the string "exec".'),
     },
     annotations: {
         title: 'Extract Cascade',
@@ -222,12 +236,13 @@ RETURNS: Summary with extracted_count and output_directory path. Read the output
         idempotentHint: true,
         openWorldHint: false,
     },
-}, async ({ asset_paths, scope, max_depth }) => {
+}, async ({ asset_paths, scope, max_depth, graph_filter, compact }) => {
     try {
         const result = await client.callSubsystem('ExtractCascade', {
             AssetPathsJson: JSON.stringify(asset_paths),
             Scope: scope,
             MaxDepth: max_depth,
+            GraphFilter: graph_filter ? graph_filter.join(',') : '',
         });
         const parsed = JSON.parse(result);
         if (parsed.error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blueprint-extractor-mcp",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "MCP server for UE5 BlueprintExtractor plugin",
   "type": "module",
   "main": "dist/index.js",