unreal-engine-mcp-server 0.4.5 → 0.4.6

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.6
 
 # Connection Settings
 MAX_RETRY_ATTEMPTS=3

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file.
 
+## [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,7 @@
 [![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)
+[![smithery badge](https://smithery.ai/badge/@ChiR24/unreal_mcp)](https://smithery.ai/server/@ChiR24/unreal_mcp)
 
 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.
 

package/dist/index.js

@@ -63,7 +63,7 @@ const CONFIG = {
     RETRY_DELAY_MS: 2000,
     // Server info
     SERVER_NAME: 'unreal-engine-mcp',
-    SERVER_VERSION: '0.4.5',
+    SERVER_VERSION: '0.4.6',
     // Monitoring
     HEALTH_CHECK_INTERVAL_MS: 30000 // 30 seconds
 };

package/dist/utils/response-validator.js

@@ -2,6 +2,66 @@ import Ajv from 'ajv';
 import { Logger } from './logger.js';
 import { cleanObject } from './safe-json.js';
 const log = new Logger('ResponseValidator');
+function isRecord(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+function normalizeText(text) {
+    return text.replace(/\s+/g, ' ').trim();
+}
+function buildSummaryText(toolName, payload) {
+    if (typeof payload === 'string') {
+        const normalized = payload.trim();
+        return normalized || `${toolName} responded`;
+    }
+    if (typeof payload === 'number' || typeof payload === 'bigint' || typeof payload === 'boolean') {
+        return `${toolName} responded: ${payload}`;
+    }
+    if (!isRecord(payload)) {
+        return `${toolName} responded`;
+    }
+    const parts = [];
+    const message = typeof payload.message === 'string' ? normalizeText(payload.message) : '';
+    const error = typeof payload.error === 'string' ? normalizeText(payload.error) : '';
+    const success = typeof payload.success === 'boolean' ? (payload.success ? 'success' : 'failed') : '';
+    const path = typeof payload.path === 'string' ? payload.path : '';
+    const name = typeof payload.name === 'string' ? payload.name : '';
+    const warningCount = Array.isArray(payload.warnings) ? payload.warnings.length : 0;
+    if (message)
+        parts.push(message);
+    if (error && (!message || !message.includes(error)))
+        parts.push(`error: ${error}`);
+    if (success)
+        parts.push(success);
+    if (path)
+        parts.push(`path: ${path}`);
+    if (name)
+        parts.push(`name: ${name}`);
+    if (warningCount > 0)
+        parts.push(`warnings: ${warningCount}`);
+    const summary = isRecord(payload.summary) ? payload.summary : undefined;
+    if (summary) {
+        const summaryParts = [];
+        for (const [key, value] of Object.entries(summary)) {
+            if (typeof value === 'number' || typeof value === 'string') {
+                summaryParts.push(`${key}: ${value}`);
+            }
+            if (summaryParts.length >= 3)
+                break;
+        }
+        if (summaryParts.length) {
+            parts.push(`summary(${summaryParts.join(', ')})`);
+        }
+    }
+    if (parts.length === 0) {
+        const keys = Object.keys(payload).slice(0, 3);
+        if (keys.length) {
+            return `${toolName} responded (${keys.join(', ')})`;
+        }
+    }
+    return parts.length > 0
+        ? parts.join(' | ')
+        : `${toolName} responded`;
+}
 /**
  * Response Validator for MCP Tool Outputs
  * Validates tool responses against their defined output schemas
@@ -127,15 +187,10 @@ export class ResponseValidator {
             return response;
         }
         // Otherwise, wrap structured result into MCP content
-        let text;
-        try {
-            // Pretty-print small objects for readability
-            text = typeof response === 'string'
-                ? response
-                : JSON.stringify(response ?? { success: true }, null, 2);
-        }
-        catch (_e) {
-            text = String(response);
+        const summarySource = structuredPayload !== undefined ? structuredPayload : response;
+        let text = buildSummaryText(toolName, summarySource);
+        if (!text || !text.trim()) {
+            text = buildSummaryText(toolName, response);
         }
         const wrapped = {
             content: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unreal-engine-mcp-server",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "mcpName": "io.github.ChiR24/unreal-engine-mcp",
   "description": "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.",
   "type": "module",

package/server.json

@@ -2,13 +2,13 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-16/server.schema.json",
   "name": "io.github.ChiR24/unreal-engine-mcp",
   "description": "MCP server for Unreal Engine 5 with 13 tools for game development automation.",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "unreal-engine-mcp-server",
-      "version": "0.4.5",
+      "version": "0.4.6",
       "transport": {
         "type": "stdio"
       },

package/src/index.ts

@@ -88,7 +88,7 @@ const CONFIG = {
   RETRY_DELAY_MS: 2000,
   // Server info
   SERVER_NAME: 'unreal-engine-mcp',
-  SERVER_VERSION: '0.4.5',
+  SERVER_VERSION: '0.4.6',
   // Monitoring
   HEALTH_CHECK_INTERVAL_MS: 30000 // 30 seconds
 };

package/src/utils/response-validator.ts

@@ -4,6 +4,69 @@ import { cleanObject } from './safe-json.js';
 
 const log = new Logger('ResponseValidator');
 
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+
+function normalizeText(text: string): string {
+  return text.replace(/\s+/g, ' ').trim();
+}
+
+function buildSummaryText(toolName: string, payload: unknown): string {
+  if (typeof payload === 'string') {
+    const normalized = payload.trim();
+    return normalized || `${toolName} responded`;
+  }
+
+  if (typeof payload === 'number' || typeof payload === 'bigint' || typeof payload === 'boolean') {
+    return `${toolName} responded: ${payload}`;
+  }
+
+  if (!isRecord(payload)) {
+    return `${toolName} responded`;
+  }
+
+  const parts: string[] = [];
+  const message = typeof payload.message === 'string' ? normalizeText(payload.message) : '';
+  const error = typeof payload.error === 'string' ? normalizeText(payload.error) : '';
+  const success = typeof payload.success === 'boolean' ? (payload.success ? 'success' : 'failed') : '';
+  const path = typeof payload.path === 'string' ? payload.path : '';
+  const name = typeof payload.name === 'string' ? payload.name : '';
+  const warningCount = Array.isArray(payload.warnings) ? payload.warnings.length : 0;
+
+  if (message) parts.push(message);
+  if (error && (!message || !message.includes(error))) parts.push(`error: ${error}`);
+  if (success) parts.push(success);
+  if (path) parts.push(`path: ${path}`);
+  if (name) parts.push(`name: ${name}`);
+  if (warningCount > 0) parts.push(`warnings: ${warningCount}`);
+
+  const summary = isRecord(payload.summary) ? payload.summary : undefined;
+  if (summary) {
+    const summaryParts: string[] = [];
+    for (const [key, value] of Object.entries(summary)) {
+      if (typeof value === 'number' || typeof value === 'string') {
+        summaryParts.push(`${key}: ${value}`);
+      }
+      if (summaryParts.length >= 3) break;
+    }
+    if (summaryParts.length) {
+      parts.push(`summary(${summaryParts.join(', ')})`);
+    }
+  }
+
+  if (parts.length === 0) {
+    const keys = Object.keys(payload).slice(0, 3);
+    if (keys.length) {
+      return `${toolName} responded (${keys.join(', ')})`;
+    }
+  }
+
+  return parts.length > 0
+    ? parts.join(' | ')
+    : `${toolName} responded`;
+}
+
 /**
  * Response Validator for MCP Tool Outputs
  * Validates tool responses against their defined output schemas
@@ -148,14 +211,10 @@ export class ResponseValidator {
     }
 
     // Otherwise, wrap structured result into MCP content
-    let text: string;
-    try {
-      // Pretty-print small objects for readability
-      text = typeof response === 'string'
-        ? response
-        : JSON.stringify(response ?? { success: true }, null, 2);
-    } catch (_e) {
-      text = String(response);
+    const summarySource = structuredPayload !== undefined ? structuredPayload : response;
+    let text = buildSummaryText(toolName, summarySource);
+    if (!text || !text.trim()) {
+      text = buildSummaryText(toolName, response);
     }
 
     const wrapped = {