@akiojin/unity-mcp-server 3.2.0 → 3.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akiojin/unity-mcp-server",
-  "version": "3.2.0",
+  "version": "3.2.1",
   "description": "MCP server and Unity Editor bridge — enables AI assistants to control Unity for AI-assisted workflows",
   "type": "module",
   "main": "src/core/server.js",

package/src/core/unityCommandType.js

@@ -0,0 +1,10 @@
+const TOOL_NAME_TO_UNITY_COMMAND_TYPE = Object.freeze({
+  // Animator tools: tool name (MCP) -> Unity command type (TCP)
+  analysis_animator_state_get: 'get_animator_state',
+  analysis_animator_runtime_info_get: 'get_animator_runtime_info'
+});
+
+export function normalizeUnityCommandType(type) {
+  if (typeof type !== 'string' || type.length === 0) return type;
+  return TOOL_NAME_TO_UNITY_COMMAND_TYPE[type] ?? type;
+}

package/src/core/unityConnection.js

@@ -1,6 +1,7 @@
 import net from 'net';
 import { EventEmitter } from 'events';
 import { config, logger } from './config.js';
+import { normalizeUnityCommandType } from './unityCommandType.js';
 
 /**
  * Manages TCP connection to Unity Editor
@@ -360,7 +361,8 @@ export class UnityConnection extends EventEmitter {
    * @returns {Promise<any>} - Response from Unity
    */
   async sendCommand(type, params = {}) {
-    logger.info(`[Unity] enqueue sendCommand: ${type}`, { connected: this.connected });
+    const normalizedType = normalizeUnityCommandType(type);
+    logger.info(`[Unity] enqueue sendCommand: ${normalizedType}`, { connected: this.connected });
 
     if (!this.connected) {
       logger.warning('[Unity] Not connected; waiting for reconnection before sending command');
@@ -371,7 +373,7 @@ export class UnityConnection extends EventEmitter {
 
     // Create an external promise that will resolve when Unity responds
     return new Promise((outerResolve, outerReject) => {
-      const task = { type, params, outerResolve, outerReject };
+      const task = { type: normalizedType, params, outerResolve, outerReject };
       this.sendQueue.push(task);
       this._pumpQueue();
     });

package/src/tools/analysis/analyzeSceneContents.js

@@ -47,7 +47,7 @@ export async function analyzeSceneContentsHandler(unityConnection, args) {
     }
 
     // Send command to Unity with provided parameters
-    const result = await unityConnection.sendCommand('analysis_scene_contents_analyze', args);
+    const result = await unityConnection.sendCommand('analyze_scene_contents', args);
 
     // The unityConnection.sendCommand already extracts the result field
     // from the response, so we access properties directly on result

package/src/tools/analysis/findByComponent.js

@@ -48,10 +48,23 @@ export async function findByComponentHandler(unityConnection, args) {
     }
 
     // Send command to Unity
-    const result = await unityConnection.sendCommand('analysis_component_find', args);
+    const result = await unityConnection.sendCommand('find_by_component', args);
 
-    // Handle Unity response
-    if (result.status === 'error') {
+    // The unityConnection.sendCommand already extracts the result field
+    // from the response, so we access properties directly on result
+    if (!result || typeof result === 'string') {
+      return {
+        content: [
+          {
+            type: 'text',
+            text: `Failed to find GameObjects: Invalid response format`
+          }
+        ],
+        isError: true
+      };
+    }
+
+    if (result.error) {
       return {
         content: [
           {
@@ -63,12 +76,14 @@ export async function findByComponentHandler(unityConnection, args) {
       };
     }
 
+    const summary = result.summary || `Found ${result.totalFound ?? 0} GameObjects`;
+
     // Success response
     return {
       content: [
         {
           type: 'text',
-          text: result.result.summary || `Found ${result.result.totalFound} GameObjects`
+          text: summary
         }
       ],
       isError: false

package/src/tools/analysis/getAnimatorState.js

@@ -99,8 +99,8 @@ export async function getAnimatorStateHandler(unityConnection, args) {
       };
     }
 
-    // Send command to Unity
-    const result = await unityConnection.sendCommand('analysis_animator_state_get', args);
+    // Send command to Unity (tool name is normalized to Unity command type in UnityConnection)
+    const result = await unityConnection.sendCommand(getAnimatorStateToolDefinition.name, args);
 
     // Check for errors
     if (!result || typeof result === 'string') {
@@ -221,8 +221,11 @@ export async function getAnimatorRuntimeInfoHandler(unityConnection, args) {
       };
     }
 
-    // Send command to Unity
-    const result = await unityConnection.sendCommand('analysis_animator_runtime_info_get', args);
+    // Send command to Unity (tool name is normalized to Unity command type in UnityConnection)
+    const result = await unityConnection.sendCommand(
+      getAnimatorRuntimeInfoToolDefinition.name,
+      args
+    );
 
     // Check for errors
     if (!result || typeof result === 'string') {

package/src/tools/analysis/getComponentValues.js

@@ -77,7 +77,7 @@ export async function getComponentValuesHandler(unityConnection, args) {
     }
 
     // Send command to Unity
-    const result = await unityConnection.sendCommand('analysis_component_values_get', args);
+    const result = await unityConnection.sendCommand('get_component_values', args);
 
     // The unityConnection.sendCommand already extracts the result field
     // from the response, so we access properties directly on result
@@ -106,6 +106,7 @@ export async function getComponentValuesHandler(unityConnection, args) {
       };
     }
 
+    // Success response - result is already the unwrapped data
     let responseText = result.summary || `Component values retrieved`;
 
     // Add detailed property information if available

package/src/tools/analysis/getGameObjectDetails.js

@@ -106,7 +106,7 @@ export async function getGameObjectDetailsHandler(unityConnection, args) {
     if (args.maxDepth !== undefined) params.maxDepth = args.maxDepth;
 
     // Send command to Unity
-    const result = await unityConnection.sendCommand('analysis_gameobject_details_get', args);
+    const result = await unityConnection.sendCommand('get_gameobject_details', params);
 
     // The unityConnection.sendCommand already extracts the result field
     // from the response, so we access properties directly on result

package/src/tools/analysis/getInputActionsState.js

@@ -75,7 +75,7 @@ export async function getInputActionsStateHandler(unityConnection, args) {
     }
 
     // Send command to Unity
-    const result = await unityConnection.sendCommand('input_actions_state_get', args);
+    const result = await unityConnection.sendCommand('get_input_actions_state', args);
 
     // Check for errors
     if (!result || typeof result === 'string') {
@@ -216,7 +216,7 @@ export async function analyzeInputActionsAssetHandler(unityConnection, args) {
     }
 
     // Send command to Unity
-    const result = await unityConnection.sendCommand('input_actions_asset_analyze', args);
+    const result = await unityConnection.sendCommand('analyze_input_actions_asset', args);
 
     // Check for errors
     if (!result || typeof result === 'string') {

package/src/tools/analysis/getObjectReferences.js

@@ -47,10 +47,23 @@ export async function getObjectReferencesHandler(unityConnection, args) {
     }
 
     // Send command to Unity
-    const result = await unityConnection.sendCommand('analysis_object_references_get', args);
+    const result = await unityConnection.sendCommand('get_object_references', args);
 
-    // Handle Unity response
-    if (result.status === 'error') {
+    // The unityConnection.sendCommand already extracts the result field
+    // from the response, so we access properties directly on result
+    if (!result || typeof result === 'string') {
+      return {
+        content: [
+          {
+            type: 'text',
+            text: `Failed to get object references: Invalid response format`
+          }
+        ],
+        isError: true
+      };
+    }
+
+    if (result.error) {
       return {
         content: [
           {
@@ -67,7 +80,7 @@ export async function getObjectReferencesHandler(unityConnection, args) {
       content: [
         {
           type: 'text',
-          text: result.result.summary || `References analyzed for ${args.gameObjectName}`
+          text: result.summary || `References analyzed for ${args.gameObjectName}`
         }
       ],
       isError: false

package/src/tools/input/inputActionsEditor.js

@@ -303,7 +303,10 @@ function formatUnityResponse(result, successMessage) {
   }
 
   if (result.success) {
-    let text = result.message || successMessage;
+    let text = successMessage || result.message || 'Operation completed';
+    if (successMessage && result.message && result.message !== successMessage) {
+      text += `\n${result.message}`;
+    }
     // Add any additional info from result
     Object.keys(result).forEach(key => {
       if (key !== 'success' && key !== 'message' && key !== 'error') {
@@ -348,7 +351,7 @@ export async function createActionMapHandler(unityConnection, args) {
       };
     }
 
-    const result = await unityConnection.sendCommand('input_action_map_create', args);
+    const result = await unityConnection.sendCommand('create_action_map', args);
     return formatUnityResponse(result, `Created Action Map: ${args.mapName}`);
   } catch (error) {
     return {
@@ -377,7 +380,7 @@ export async function removeActionMapHandler(unityConnection, args) {
       };
     }
 
-    const result = await unityConnection.sendCommand('input_action_map_remove', args);
+    const result = await unityConnection.sendCommand('remove_action_map', args);
     return formatUnityResponse(result, `Removed Action Map: ${args.mapName}`);
   } catch (error) {
     return {
@@ -407,7 +410,7 @@ export async function addInputActionHandler(unityConnection, args) {
       };
     }
 
-    const result = await unityConnection.sendCommand('input_action_add', args);
+    const result = await unityConnection.sendCommand('add_input_action', args);
     return formatUnityResponse(result, `Added Action: ${args.actionName}`);
   } catch (error) {
     return {
@@ -436,7 +439,7 @@ export async function removeInputActionHandler(unityConnection, args) {
       };
     }
 
-    const result = await unityConnection.sendCommand('input_action_remove', args);
+    const result = await unityConnection.sendCommand('remove_input_action', args);
     return formatUnityResponse(result, `Removed Action: ${args.actionName}`);
   } catch (error) {
     return {
@@ -466,7 +469,7 @@ export async function addInputBindingHandler(unityConnection, args) {
       };
     }
 
-    const result = await unityConnection.sendCommand('input_binding_add', args);
+    const result = await unityConnection.sendCommand('add_input_binding', args);
     return formatUnityResponse(result, `Added Binding: ${args.path}`);
   } catch (error) {
     return {
@@ -495,7 +498,7 @@ export async function removeInputBindingHandler(unityConnection, args) {
       };
     }
 
-    const result = await unityConnection.sendCommand('input_binding_remove', args);
+    const result = await unityConnection.sendCommand('remove_input_binding', args);
     return formatUnityResponse(result, 'Removed Binding');
   } catch (error) {
     return {
@@ -524,7 +527,7 @@ export async function removeAllBindingsHandler(unityConnection, args) {
       };
     }
 
-    const result = await unityConnection.sendCommand('input_binding_remove_all', args);
+    const result = await unityConnection.sendCommand('remove_all_bindings', args);
     return formatUnityResponse(result, `Removed all bindings from ${args.actionName}`);
   } catch (error) {
     return {
@@ -553,7 +556,7 @@ export async function createCompositeBindingHandler(unityConnection, args) {
       };
     }
 
-    const result = await unityConnection.sendCommand('input_binding_composite_create', args);
+    const result = await unityConnection.sendCommand('create_composite_binding', args);
     return formatUnityResponse(
       result,
       `Created composite binding: ${args.name || args.compositeType}`
@@ -586,7 +589,7 @@ export async function manageControlSchemesHandler(unityConnection, args) {
       };
     }
 
-    const result = await unityConnection.sendCommand('input_control_schemes_manage', args);
+    const result = await unityConnection.sendCommand('manage_control_schemes', args);
     const operationText =
       args.operation === 'add' ? 'Added' : args.operation === 'remove' ? 'Removed' : 'Modified';
     return formatUnityResponse(result, `${operationText} control scheme: ${args.schemeName}`);