unreal-engine-mcp-server 0.4.5 → 0.4.7

package/.env.production

@@ -19,7 +19,7 @@ LOG_LEVEL=info
 
 # Server Settings
 SERVER_NAME=unreal-engine-mcp
-SERVER_VERSION=0.4.5
+SERVER_VERSION=0.4.7
 
 # Connection Settings
 MAX_RETRY_ATTEMPTS=3

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.4.7] - 2025-11-16
+### Added
+- Output Log reading via `system_control` tool with `read_log` action. Supports filtering by category (comma-separated or array), log level (Error, Warning, Log, Verbose, VeryVerbose, All), line count (up to 2000), specific log path, include prefixes, and exclude categories. Automatically resolves the latest project log under Saved/Logs.
+- New `src/tools/logs.ts` implementing robust log tailing, parsing (timestamp/category/level/message), and UE-specific internal entry filtering (e.g., excludes LogPython RESULT: blocks unless requested).
+
+### Changed
+- `system_control` tool schema: Added `read_log` action with full filter parameters to inputSchema; extended outputSchema with `logPath`, `entries` array, and `filteredCount`.
+- Updated `src/tools/consolidated-tool-handlers.ts` to route `read_log` to LogTools without requiring UE connection (file-based).
+- `src/index.ts`: Instantiates and passes LogTools to consolidated handler.
+- Version bumped to 0.4.7 in package.json, package-lock.json, server.json, .env.production, and runtime config.
+
+## [0.4.6] - 2025-10-04
+### Fixed
+- Fixed duplicate response output issue where tool responses were being displayed twice in MCP content
+- Response validator now emits concise summaries in text content instead of duplicating full JSON payloads
+- Structured content is preserved for validation and tests while user-facing output is streamlined
+
 ## [0.4.5] - 2025-10-03
 ### Added
 - Expose `UE_PROJECT_PATH` environment variable across runtime config, Smithery manifest, and client example configs. This allows tools that need an absolute .uproject path (e.g., engine_start) to work without additional manual configuration.

package/README.md

@@ -5,7 +5,6 @@
 [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-TypeScript-blue)](https://github.com/modelcontextprotocol/sdk)
 [![Unreal Engine](https://img.shields.io/badge/Unreal%20Engine-5.0--5.6-orange)](https://www.unrealengine.com/)
 [![MCP Registry](https://img.shields.io/badge/MCP%20Registry-Published-green)](https://registry.modelcontextprotocol.io/)
-[![smithery badge](https://smithery.ai/badge/@ChiR24/unreal_mcp_server)](https://smithery.ai/server/@ChiR24/unreal_mcp_server)
 
 A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal Engine via Remote Control API. Built with TypeScript and designed for game development automation.
 
@@ -145,7 +144,7 @@ Then enable Python execution in: Edit > Project Settings > Plugins > Remote Cont
 | `create_effect` | Particles, Niagara, debug shapes |
 | `manage_blueprint` | Create blueprints, add components |
 | `build_environment` | Landscapes, terrain, foliage |
-| `system_control` | Profiling, quality, UI, screenshots |
+| `system_control` | Profiling, quality, UI, screenshots, Output Log reading |
 | `console_command` | Direct console command execution |
 | `manage_rc` | Remote Control presets |
 | `manage_sequence` | Sequencer/cinematics |

package/dist/index.js

@@ -28,6 +28,7 @@ import { SequenceTools } from './tools/sequence.js';
 import { IntrospectionTools } from './tools/introspection.js';
 import { VisualTools } from './tools/visual.js';
 import { EngineTools } from './tools/engine.js';
+import { LogTools } from './tools/logs.js';
 import { consolidatedToolDefinitions } from './tools/consolidated-tool-definitions.js';
 import { handleConsolidatedToolCall } from './tools/consolidated-tool-handlers.js';
 import { prompts } from './prompts/index.js';
@@ -63,7 +64,7 @@ const CONFIG = {
     RETRY_DELAY_MS: 2000,
     // Server info
     SERVER_NAME: 'unreal-engine-mcp',
-    SERVER_VERSION: '0.4.5',
+    SERVER_VERSION: '0.4.7',
     // Monitoring
     HEALTH_CHECK_INTERVAL_MS: 30000 // 30 seconds
 };
@@ -206,6 +207,7 @@ export function createServer() {
     const introspectionTools = new IntrospectionTools(bridge);
     const visualTools = new VisualTools(bridge);
     const engineTools = new EngineTools(bridge);
+    const logTools = new LogTools(bridge);
     const server = new Server({
         name: CONFIG.SERVER_NAME,
         version: CONFIG.SERVER_VERSION
@@ -430,11 +432,23 @@ export function createServer() {
         const { name } = request.params;
         let args = request.params.arguments || {};
         const startTime = Date.now();
-        // Ensure connection only when needed, with 3 attempts
-        const connected = await ensureConnectedOnDemand();
-        if (!connected) {
-            trackPerformance(startTime, false);
-            return createNotConnectedResponse(name);
+        let requiresEngine = true;
+        try {
+            const n = String(name);
+            if (n === 'system_control') {
+                const action = String((args || {}).action || '').trim();
+                if (action === 'read_log') {
+                    requiresEngine = false;
+                }
+            }
+        }
+        catch { }
+        if (requiresEngine) {
+            const connected = await ensureConnectedOnDemand();
+            if (!connected) {
+                trackPerformance(startTime, false);
+                return createNotConnectedResponse(name);
+            }
         }
         // Create tools object for handler
         const tools = {
@@ -460,6 +474,7 @@ export function createServer() {
             introspectionTools,
             visualTools,
             engineTools,
+            logTools,
             // Elicitation (client-optional)
             elicit: elicitation.elicit,
             supportsElicitation: elicitation.supports,

package/dist/tools/consolidated-tool-definitions.d.ts

@@ -90,6 +90,12 @@ export declare const consolidatedToolDefinitions: ({
             resolution?: undefined;
             projectPath?: undefined;
             editorExe?: undefined;
+            filter_category?: undefined;
+            filter_level?: undefined;
+            lines?: undefined;
+            log_path?: undefined;
+            include_prefixes?: undefined;
+            exclude_categories?: undefined;
             command?: undefined;
             presetPath?: undefined;
             objectPath?: undefined;
@@ -186,6 +192,9 @@ export declare const consolidatedToolDefinitions: ({
             imagePath?: undefined;
             imageBase64?: undefined;
             pid?: undefined;
+            logPath?: undefined;
+            entries?: undefined;
+            filteredCount?: undefined;
             command?: undefined;
             result?: undefined;
             info?: undefined;
@@ -340,6 +349,12 @@ export declare const consolidatedToolDefinitions: ({
             resolution?: undefined;
             projectPath?: undefined;
             editorExe?: undefined;
+            filter_category?: undefined;
+            filter_level?: undefined;
+            lines?: undefined;
+            log_path?: undefined;
+            include_prefixes?: undefined;
+            exclude_categories?: undefined;
             command?: undefined;
             presetPath?: undefined;
             objectPath?: undefined;
@@ -416,6 +431,9 @@ export declare const consolidatedToolDefinitions: ({
             imagePath?: undefined;
             imageBase64?: undefined;
             pid?: undefined;
+            logPath?: undefined;
+            entries?: undefined;
+            filteredCount?: undefined;
             command?: undefined;
             result?: undefined;
             info?: undefined;
@@ -550,6 +568,12 @@ export declare const consolidatedToolDefinitions: ({
             resolution?: undefined;
             projectPath?: undefined;
             editorExe?: undefined;
+            filter_category?: undefined;
+            filter_level?: undefined;
+            lines?: undefined;
+            log_path?: undefined;
+            include_prefixes?: undefined;
+            exclude_categories?: undefined;
             command?: undefined;
             presetPath?: undefined;
             objectPath?: undefined;
@@ -632,6 +656,9 @@ export declare const consolidatedToolDefinitions: ({
             imagePath?: undefined;
             imageBase64?: undefined;
             pid?: undefined;
+            logPath?: undefined;
+            entries?: undefined;
+            filteredCount?: undefined;
             command?: undefined;
             result?: undefined;
             info?: undefined;
@@ -775,6 +802,12 @@ export declare const consolidatedToolDefinitions: ({
             resolution?: undefined;
             projectPath?: undefined;
             editorExe?: undefined;
+            filter_category?: undefined;
+            filter_level?: undefined;
+            lines?: undefined;
+            log_path?: undefined;
+            include_prefixes?: undefined;
+            exclude_categories?: undefined;
             command?: undefined;
             presetPath?: undefined;
             objectPath?: undefined;
@@ -854,6 +887,9 @@ export declare const consolidatedToolDefinitions: ({
             imagePath?: undefined;
             imageBase64?: undefined;
             pid?: undefined;
+            logPath?: undefined;
+            entries?: undefined;
+            filteredCount?: undefined;
             command?: undefined;
             result?: undefined;
             info?: undefined;
@@ -978,6 +1014,12 @@ export declare const consolidatedToolDefinitions: ({
             resolution?: undefined;
             projectPath?: undefined;
             editorExe?: undefined;
+            filter_category?: undefined;
+            filter_level?: undefined;
+            lines?: undefined;
+            log_path?: undefined;
+            include_prefixes?: undefined;
+            exclude_categories?: undefined;
             command?: undefined;
             presetPath?: undefined;
             objectPath?: undefined;
@@ -1054,6 +1096,9 @@ export declare const consolidatedToolDefinitions: ({
             imagePath?: undefined;
             imageBase64?: undefined;
             pid?: undefined;
+            logPath?: undefined;
+            entries?: undefined;
+            filteredCount?: undefined;
             command?: undefined;
             result?: undefined;
             info?: undefined;
@@ -1195,6 +1240,12 @@ export declare const consolidatedToolDefinitions: ({
             resolution?: undefined;
             projectPath?: undefined;
             editorExe?: undefined;
+            filter_category?: undefined;
+            filter_level?: undefined;
+            lines?: undefined;
+            log_path?: undefined;
+            include_prefixes?: undefined;
+            exclude_categories?: undefined;
             command?: undefined;
             presetPath?: undefined;
             objectPath?: undefined;
@@ -1274,6 +1325,9 @@ export declare const consolidatedToolDefinitions: ({
             imagePath?: undefined;
             imageBase64?: undefined;
             pid?: undefined;
+            logPath?: undefined;
+            entries?: undefined;
+            filteredCount?: undefined;
             command?: undefined;
             result?: undefined;
             info?: undefined;
@@ -1386,6 +1440,12 @@ export declare const consolidatedToolDefinitions: ({
             resolution?: undefined;
             projectPath?: undefined;
             editorExe?: undefined;
+            filter_category?: undefined;
+            filter_level?: undefined;
+            lines?: undefined;
+            log_path?: undefined;
+            include_prefixes?: undefined;
+            exclude_categories?: undefined;
             command?: undefined;
             presetPath?: undefined;
             objectPath?: undefined;
@@ -1459,6 +1519,9 @@ export declare const consolidatedToolDefinitions: ({
             imagePath?: undefined;
             imageBase64?: undefined;
             pid?: undefined;
+            logPath?: undefined;
+            entries?: undefined;
+            filteredCount?: undefined;
             command?: undefined;
             result?: undefined;
             info?: undefined;
@@ -1733,6 +1796,12 @@ export declare const consolidatedToolDefinitions: ({
             resolution?: undefined;
             projectPath?: undefined;
             editorExe?: undefined;
+            filter_category?: undefined;
+            filter_level?: undefined;
+            lines?: undefined;
+            log_path?: undefined;
+            include_prefixes?: undefined;
+            exclude_categories?: undefined;
             command?: undefined;
             presetPath?: undefined;
             objectPath?: undefined;
@@ -1806,6 +1875,9 @@ export declare const consolidatedToolDefinitions: ({
             imagePath?: undefined;
             imageBase64?: undefined;
             pid?: undefined;
+            logPath?: undefined;
+            entries?: undefined;
+            filteredCount?: undefined;
             command?: undefined;
             result?: undefined;
             info?: undefined;
@@ -1911,6 +1983,36 @@ export declare const consolidatedToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            filter_category: {
+                description: string;
+            };
+            filter_level: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            lines: {
+                type: string;
+                description: string;
+            };
+            log_path: {
+                type: string;
+                description: string;
+            };
+            include_prefixes: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            exclude_categories: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
             directory?: undefined;
             sourcePath?: undefined;
             destinationPath?: undefined;
@@ -2030,6 +2132,35 @@ export declare const consolidatedToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            logPath: {
+                type: string;
+                description: string;
+            };
+            entries: {
+                type: string;
+                items: {
+                    type: string;
+                    properties: {
+                        timestamp: {
+                            type: string;
+                        };
+                        category: {
+                            type: string;
+                        };
+                        level: {
+                            type: string;
+                        };
+                        message: {
+                            type: string;
+                        };
+                    };
+                };
+                description: string;
+            };
+            filteredCount: {
+                type: string;
+                description: string;
+            };
             assets?: undefined;
             paths?: undefined;
             materialPath?: undefined;
@@ -2153,6 +2284,12 @@ export declare const consolidatedToolDefinitions: ({
             resolution?: undefined;
             projectPath?: undefined;
             editorExe?: undefined;
+            filter_category?: undefined;
+            filter_level?: undefined;
+            lines?: undefined;
+            log_path?: undefined;
+            include_prefixes?: undefined;
+            exclude_categories?: undefined;
             presetPath?: undefined;
             objectPath?: undefined;
             propertyName?: undefined;
@@ -2231,6 +2368,9 @@ export declare const consolidatedToolDefinitions: ({
             imagePath?: undefined;
             imageBase64?: undefined;
             pid?: undefined;
+            logPath?: undefined;
+            entries?: undefined;
+            filteredCount?: undefined;
             presetPath?: undefined;
             fields?: undefined;
             value?: undefined;
@@ -2349,6 +2489,12 @@ export declare const consolidatedToolDefinitions: ({
             resolution?: undefined;
             projectPath?: undefined;
             editorExe?: undefined;
+            filter_category?: undefined;
+            filter_level?: undefined;
+            lines?: undefined;
+            log_path?: undefined;
+            include_prefixes?: undefined;
+            exclude_categories?: undefined;
             command?: undefined;
             actorNames?: undefined;
             className?: undefined;
@@ -2422,6 +2568,9 @@ export declare const consolidatedToolDefinitions: ({
             imagePath?: undefined;
             imageBase64?: undefined;
             pid?: undefined;
+            logPath?: undefined;
+            entries?: undefined;
+            filteredCount?: undefined;
             command?: undefined;
             result?: undefined;
             info?: undefined;
@@ -2565,6 +2714,12 @@ export declare const consolidatedToolDefinitions: ({
             resolution?: undefined;
             projectPath?: undefined;
             editorExe?: undefined;
+            filter_category?: undefined;
+            filter_level?: undefined;
+            lines?: undefined;
+            log_path?: undefined;
+            include_prefixes?: undefined;
+            exclude_categories?: undefined;
             command?: undefined;
             presetPath?: undefined;
             objectPath?: undefined;
@@ -2671,6 +2826,9 @@ export declare const consolidatedToolDefinitions: ({
             imagePath?: undefined;
             imageBase64?: undefined;
             pid?: undefined;
+            logPath?: undefined;
+            entries?: undefined;
+            filteredCount?: undefined;
             command?: undefined;
             result?: undefined;
             info?: undefined;
@@ -2767,6 +2925,12 @@ export declare const consolidatedToolDefinitions: ({
             resolution?: undefined;
             projectPath?: undefined;
             editorExe?: undefined;
+            filter_category?: undefined;
+            filter_level?: undefined;
+            lines?: undefined;
+            log_path?: undefined;
+            include_prefixes?: undefined;
+            exclude_categories?: undefined;
             command?: undefined;
             presetPath?: undefined;
             actorNames?: undefined;
@@ -2835,6 +2999,9 @@ export declare const consolidatedToolDefinitions: ({
             imagePath?: undefined;
             imageBase64?: undefined;
             pid?: undefined;
+            logPath?: undefined;
+            entries?: undefined;
+            filteredCount?: undefined;
             command?: undefined;
             result?: undefined;
             presetPath?: undefined;

package/dist/tools/consolidated-tool-definitions.js

@@ -528,7 +528,7 @@ Supported actions: profile, show_fps, set_quality, play_sound, create_widget, sh
             properties: {
                 action: {
                     type: 'string',
-                    enum: ['profile', 'show_fps', 'set_quality', 'play_sound', 'create_widget', 'show_widget', 'screenshot', 'engine_start', 'engine_quit'],
+                    enum: ['profile', 'show_fps', 'set_quality', 'play_sound', 'create_widget', 'show_widget', 'screenshot', 'engine_start', 'engine_quit', 'read_log'],
                     description: 'System action'
                 },
                 // Performance
@@ -567,7 +567,14 @@ Supported actions: profile, show_fps, set_quality, play_sound, create_widget, sh
                 resolution: { type: 'string', description: 'Screenshot resolution in WIDTHxHEIGHT format (e.g., "1920x1080", "3840x2160"). Optional for screenshot action, uses viewport size if not specified.' },
                 // Engine lifecycle
                 projectPath: { type: 'string', description: 'Absolute path to .uproject file (e.g., "C:/Projects/MyGame/MyGame.uproject"). Required for engine_start unless UE_PROJECT_PATH environment variable is set.' },
-                editorExe: { type: 'string', description: 'Absolute path to Unreal Editor executable (e.g., "C:/UnrealEngine/Engine/Binaries/Win64/UnrealEditor.exe"). Required for engine_start unless UE_EDITOR_EXE environment variable is set.' }
+                editorExe: { type: 'string', description: 'Absolute path to Unreal Editor executable (e.g., "C:/UnrealEngine/Engine/Binaries/Win64/UnrealEditor.exe"). Required for engine_start unless UE_EDITOR_EXE environment variable is set.' },
+                // Log reading
+                filter_category: { description: 'Category filter as string or array; comma-separated or array values' },
+                filter_level: { type: 'string', enum: ['Error', 'Warning', 'Log', 'Verbose', 'VeryVerbose', 'All'], description: 'Log level filter' },
+                lines: { type: 'number', description: 'Number of lines to read from tail' },
+                log_path: { type: 'string', description: 'Absolute path to a specific .log file to read' },
+                include_prefixes: { type: 'array', items: { type: 'string' }, description: 'Only include categories starting with any of these prefixes' },
+                exclude_categories: { type: 'array', items: { type: 'string' }, description: 'Categories to exclude' }
             },
             required: ['action']
         },
@@ -585,7 +592,14 @@ Supported actions: profile, show_fps, set_quality, play_sound, create_widget, sh
                 imageBase64: { type: 'string', description: 'Screenshot image base64 (truncated)' },
                 pid: { type: 'number', description: 'Process ID for launched editor' },
                 message: { type: 'string', description: 'Status message' },
-                error: { type: 'string', description: 'Error message if failed' }
+                error: { type: 'string', description: 'Error message if failed' },
+                logPath: { type: 'string', description: 'Log file path used for read_log' },
+                entries: {
+                    type: 'array',
+                    items: { type: 'object', properties: { timestamp: { type: 'string' }, category: { type: 'string' }, level: { type: 'string' }, message: { type: 'string' } } },
+                    description: 'Parsed Output Log entries'
+                },
+                filteredCount: { type: 'number', description: 'Count of entries after filtering' }
             }
         }
     },

package/dist/tools/consolidated-tool-handlers.js

@@ -705,6 +705,23 @@ print('RESULT:' + json.dumps({'success': exists, 'exists': exists, 'path': path}
             // 9. SYSTEM CONTROL
             case 'system_control':
                 switch (requireAction(args)) {
+                    case 'read_log': {
+                        const filterCategoryRaw = args.filter_category;
+                        const filterCategory = Array.isArray(filterCategoryRaw)
+                            ? filterCategoryRaw
+                            : typeof filterCategoryRaw === 'string' && filterCategoryRaw.trim() !== ''
+                                ? filterCategoryRaw.split(',').map((s) => s.trim()).filter(Boolean)
+                                : undefined;
+                        const res = await tools.logTools.readOutputLog({
+                            filterCategory,
+                            filterLevel: args.filter_level,
+                            lines: typeof args.lines === 'number' ? args.lines : undefined,
+                            logPath: typeof args.log_path === 'string' ? args.log_path : undefined,
+                            includePrefixes: Array.isArray(args.include_prefixes) ? args.include_prefixes : undefined,
+                            excludeCategories: Array.isArray(args.exclude_categories) ? args.exclude_categories : undefined
+                        });
+                        return cleanObject(res);
+                    }
                     case 'profile': {
                         const res = await tools.performanceTools.startProfiling({ type: args.profileType, duration: args.duration });
                         return cleanObject(res);

package/dist/tools/logs.d.ts

@@ -0,0 +1,45 @@
+import { UnrealBridge } from '../unreal-bridge.js';
+type ReadParams = {
+    filterCategory?: string[];
+    filterLevel?: 'Error' | 'Warning' | 'Log' | 'Verbose' | 'VeryVerbose' | 'All';
+    lines?: number;
+    logPath?: string;
+    includePrefixes?: string[];
+    excludeCategories?: string[];
+};
+type Entry = {
+    timestamp?: string;
+    category?: string;
+    level?: string;
+    message: string;
+};
+export declare class LogTools {
+    private bridge;
+    private env;
+    private log;
+    private cachedLogPath?;
+    constructor(bridge: UnrealBridge);
+    readOutputLog(params: ReadParams): Promise<{
+        success: boolean;
+        error: string;
+        logPath?: undefined;
+        entries?: undefined;
+        filteredCount?: undefined;
+    } | {
+        success: boolean;
+        logPath: string;
+        entries: Entry[];
+        filteredCount: number;
+        error?: undefined;
+    }>;
+    private resolveLogPath;
+    private resolveFromProjectEnv;
+    private findLatestLogInDir;
+    private fileExists;
+    private cacheLogPath;
+    private tailFile;
+    private parseLine;
+    private isInternalLogEntry;
+}
+export {};
+//# sourceMappingURL=logs.d.ts.map