@akiojin/unity-mcp-server 2.40.1 → 2.40.3

package/README.md

@@ -332,6 +332,27 @@ npm uninstall -g @akiojin/unity-mcp-server
 npm install -g @akiojin/unity-mcp-server
 ```
 
+### MCP Client Shows "Capabilities: none"
+
+If your MCP client (Claude Code, Cursor, etc.) shows "Capabilities: none" despite successful connection:
+
+**Symptom**: Server connects successfully, but no tools are visible to the client.
+
+**Root Cause**: Empty capability objects (`resources: {}`, `prompts: {}`) in MCP SDK v0.6.1 cause capability validation to fail silently.
+
+**Solution**: Update to latest version with the fix:
+
+```bash
+# Update to latest version (2.41.0+)
+npm update -g @akiojin/unity-mcp-server
+
+# Or reinstall
+npm uninstall -g @akiojin/unity-mcp-server
+npm install -g @akiojin/unity-mcp-server
+```
+
+**Verification**: After restart, your MCP client should display 107 available tools.
+
 ## Repository
 
 Full source code and documentation: <https://github.com/akiojin/unity-mcp-server>

package/bin/unity-mcp-server

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { startServer } from '../src/core/server.js';
 
-startServer().catch((error) => {
+startServer().catch(error => {
   console.error('Fatal error:', error);
   console.error('Stack trace:', error?.stack);
   process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akiojin/unity-mcp-server",
-  "version": "2.40.1",
+  "version": "2.40.3",
   "description": "MCP server and Unity Editor bridge — enables AI assistants to control Unity for AI-assisted workflows",
   "type": "module",
   "main": "src/core/server.js",
@@ -26,11 +26,11 @@
     "simulate:code-index": "node scripts/simulate-code-index-status.mjs",
     "test:verbose": "VERBOSE_TEST=true node --test tests/**/*.test.js",
     "prepare": "cd .. && husky || true",
-    "prepublishOnly": "pnpm run test:ci",
+    "prepublishOnly": "npm run test:ci",
     "postinstall": "chmod +x bin/unity-mcp-server || true",
     "test:ci:unity": "timeout 60 node --test tests/unit/core/codeIndex.test.js tests/unit/core/codeIndexDb.test.js tests/unit/core/config.test.js tests/unit/core/indexWatcher.test.js tests/unit/core/projectInfo.test.js tests/unit/core/server.test.js || exit 0",
     "test:unity": "node tests/run-unity-integration.mjs",
-    "test:nounity": "pnpm run test:integration",
+    "test:nounity": "npm run test:integration",
     "test:ci:integration": "CI=true NODE_ENV=test node --test tests/integration/code-index-background.test.js"
   },
   "keywords": [
@@ -60,11 +60,6 @@
     "url": "https://github.com/akiojin/unity-mcp-server.git",
     "directory": "mcp-server"
   },
-  "pnpm": {
-    "onlyBuiltDependencies": [
-      "better-sqlite3"
-    ]
-  },
   "homepage": "https://github.com/akiojin/unity-mcp-server#readme",
   "bugs": {
     "url": "https://github.com/akiojin/unity-mcp-server/issues"

package/src/core/codeIndex.js

@@ -80,14 +80,27 @@ export class CodeIndex {
   async clearAndLoad(symbols) {
     const db = await this.open();
     if (!db) throw new Error('CodeIndex is unavailable (better-sqlite3 not installed)');
-    const insert = db.prepare('INSERT INTO symbols(path,name,kind,container,namespace,line,column) VALUES (?,?,?,?,?,?,?)');
-    const tx = db.transaction((rows) => {
+    const insert = db.prepare(
+      'INSERT INTO symbols(path,name,kind,container,namespace,line,column) VALUES (?,?,?,?,?,?,?)'
+    );
+    const tx = db.transaction(rows => {
       db.exec('DELETE FROM symbols');
       db.exec('DELETE FROM files');
       for (const r of rows) {
-        insert.run(r.path, r.name, r.kind, r.container || null, r.ns || r.namespace || null, r.line || null, r.column || null);
+        insert.run(
+          r.path,
+          r.name,
+          r.kind,
+          r.container || null,
+          r.ns || r.namespace || null,
+          r.line || null,
+          r.column || null
+        );
       }
-      db.prepare('REPLACE INTO meta(key,value) VALUES (?,?)').run('lastIndexedAt', new Date().toISOString());
+      db.prepare('REPLACE INTO meta(key,value) VALUES (?,?)').run(
+        'lastIndexedAt',
+        new Date().toISOString()
+      );
     });
     tx(symbols || []);
     return { total: symbols?.length || 0 };
@@ -106,13 +119,17 @@ export class CodeIndex {
   async upsertFile(pathStr, sig) {
     const db = await this.open();
     if (!db) return;
-    db.prepare('REPLACE INTO files(path,sig,updatedAt) VALUES (?,?,?)').run(pathStr, sig || '', new Date().toISOString());
+    db.prepare('REPLACE INTO files(path,sig,updatedAt) VALUES (?,?,?)').run(
+      pathStr,
+      sig || '',
+      new Date().toISOString()
+    );
   }
 
   async removeFile(pathStr) {
     const db = await this.open();
     if (!db) return;
-    const tx = db.transaction((p) => {
+    const tx = db.transaction(p => {
       db.prepare('DELETE FROM symbols WHERE path = ?').run(p);
       db.prepare('DELETE FROM files WHERE path = ?').run(p);
     });
@@ -124,9 +141,23 @@ export class CodeIndex {
     if (!db) return;
     const tx = db.transaction((p, list) => {
       db.prepare('DELETE FROM symbols WHERE path = ?').run(p);
-      const insert = db.prepare('INSERT INTO symbols(path,name,kind,container,namespace,line,column) VALUES (?,?,?,?,?,?,?)');
-      for (const r of list) insert.run(p, r.name, r.kind, r.container || null, r.ns || r.namespace || null, r.line || null, r.column || null);
-      db.prepare('REPLACE INTO meta(key,value) VALUES (?,?)').run('lastIndexedAt', new Date().toISOString());
+      const insert = db.prepare(
+        'INSERT INTO symbols(path,name,kind,container,namespace,line,column) VALUES (?,?,?,?,?,?,?)'
+      );
+      for (const r of list)
+        insert.run(
+          p,
+          r.name,
+          r.kind,
+          r.container || null,
+          r.ns || r.namespace || null,
+          r.line || null,
+          r.column || null
+        );
+      db.prepare('REPLACE INTO meta(key,value) VALUES (?,?)').run(
+        'lastIndexedAt',
+        new Date().toISOString()
+      );
     });
     tx(pathStr, rows || []);
   }
@@ -137,27 +168,45 @@ export class CodeIndex {
     let sql = 'SELECT path,name,kind,container,namespace,line,column FROM symbols WHERE 1=1';
     const params = {};
     if (name) {
-      if (exact) { sql += ' AND name = @name'; params.name = name; }
-      else { sql += ' AND name LIKE @name'; params.name = `%${name}%`; }
+      if (exact) {
+        sql += ' AND name = @name';
+        params.name = name;
+      } else {
+        sql += ' AND name LIKE @name';
+        params.name = `%${name}%`;
+      }
+    }
+    if (kind) {
+      sql += ' AND kind = @kind';
+      params.kind = kind;
     }
-    if (kind) { sql += ' AND kind = @kind'; params.kind = kind; }
     const rows = db.prepare(sql).all(params);
     // Apply path-based scope filter in JS (simpler than CASE in SQL)
     const filtered = rows.filter(r => {
       const p = String(r.path || '').replace(/\\\\/g, '/');
       if (scope === 'assets') return p.startsWith('Assets/');
-      if (scope === 'packages') return p.startsWith('Packages/') || p.includes('Library/PackageCache/');
+      if (scope === 'packages')
+        return p.startsWith('Packages/') || p.includes('Library/PackageCache/');
       if (scope === 'embedded') return p.startsWith('Packages/');
       return true;
     });
-    return filtered.map(r => ({ path: r.path, name: r.name, kind: r.kind, container: r.container, ns: r.namespace, line: r.line, column: r.column }));
+    return filtered.map(r => ({
+      path: r.path,
+      name: r.name,
+      kind: r.kind,
+      container: r.container,
+      ns: r.namespace,
+      line: r.line,
+      column: r.column
+    }));
   }
 
   async getStats() {
     const db = await this.open();
     if (!db) return { total: 0, lastIndexedAt: null };
     const total = db.prepare('SELECT COUNT(*) AS c FROM symbols').get().c || 0;
-    const last = db.prepare("SELECT value AS v FROM meta WHERE key = 'lastIndexedAt'").get()?.v || null;
+    const last =
+      db.prepare("SELECT value AS v FROM meta WHERE key = 'lastIndexedAt'").get()?.v || null;
     return { total, lastIndexedAt: last };
   }
 }

package/src/core/server.js

@@ -1,11 +1,6 @@
 #!/usr/bin/env node
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import {
-  ListToolsRequestSchema,
-  CallToolRequestSchema,
-  ListResourcesRequestSchema,
-  ListPromptsRequestSchema
-} from '@modelcontextprotocol/sdk/types.js';
+import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 // Note: filename is lowercase on disk; use exact casing for POSIX filesystems
 import { UnityConnection } from './unityConnection.js';
 import { createHandlers } from '../handlers/index.js';
@@ -29,9 +24,7 @@ const server = new Server(
     capabilities: {
       // Explicitly advertise tool support; some MCP clients expect a non-empty object
       // Setting listChanged enables future push updates if we emit notifications
-      tools: { listChanged: true },
-      resources: {},
-      prompts: {}
+      tools: { listChanged: true }
     }
   }
 );
@@ -63,20 +56,6 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
   return { tools };
 });
 
-// Handle resources listing
-server.setRequestHandler(ListResourcesRequestSchema, async () => {
-  logger.debug('[MCP] Received resources/list request');
-  // Unity MCP server doesn't provide resources
-  return { resources: [] };
-});
-
-// Handle prompts listing
-server.setRequestHandler(ListPromptsRequestSchema, async () => {
-  logger.debug('[MCP] Received prompts/list request');
-  // Unity MCP server doesn't provide prompts
-  return { prompts: [] };
-});
-
 // Handle tool execution
 server.setRequestHandler(CallToolRequestSchema, async request => {
   const { name, arguments: args } = request.params;
@@ -298,9 +277,7 @@ export async function createServer(customConfig = config) {
     },
     {
       capabilities: {
-        tools: { listChanged: true },
-        resources: {},
-        prompts: {}
+        tools: { listChanged: true }
       }
     }
   );
@@ -311,14 +288,6 @@ export async function createServer(customConfig = config) {
     return { tools };
   });
 
-  testServer.setRequestHandler(ListResourcesRequestSchema, async () => {
-    return { resources: [] };
-  });
-
-  testServer.setRequestHandler(ListPromptsRequestSchema, async () => {
-    return { prompts: [] };
-  });
-
   testServer.setRequestHandler(CallToolRequestSchema, async request => {
     const { name, arguments: args } = request.params;
 

package/src/handlers/analysis/AnalyzeSceneContentsToolHandler.js

@@ -1,35 +1,38 @@
 import { BaseToolHandler } from '../base/BaseToolHandler.js';
-import { analyzeSceneContentsToolDefinition, analyzeSceneContentsHandler } from '../../tools/analysis/analyzeSceneContents.js';
+import {
+  analyzeSceneContentsToolDefinition,
+  analyzeSceneContentsHandler
+} from '../../tools/analysis/analyzeSceneContents.js';
 
 /**
  * Handler for analyze_scene_contents tool
  */
 export class AnalyzeSceneContentsToolHandler extends BaseToolHandler {
-    constructor(unityConnection) {
-        super(
-            analyzeSceneContentsToolDefinition.name,
-            analyzeSceneContentsToolDefinition.description,
-            analyzeSceneContentsToolDefinition.inputSchema
-        );
-        this.unityConnection = unityConnection;
-        this.handler = analyzeSceneContentsHandler;
+  constructor(unityConnection) {
+    super(
+      analyzeSceneContentsToolDefinition.name,
+      analyzeSceneContentsToolDefinition.description,
+      analyzeSceneContentsToolDefinition.inputSchema
+    );
+    this.unityConnection = unityConnection;
+    this.handler = analyzeSceneContentsHandler;
+  }
+
+  async execute(args) {
+    // Check connection
+    if (!this.unityConnection.isConnected()) {
+      throw new Error('Unity connection not available');
     }
 
-    async execute(args) {
-        // Check connection
-        if (!this.unityConnection.isConnected()) {
-            throw new Error('Unity connection not available');
-        }
+    // Use the handler function
+    const result = await this.handler(this.unityConnection, args);
 
-        // Use the handler function
-        const result = await this.handler(this.unityConnection, args);
-        
-        // If the handler returns an error response, throw it
-        if (result.isError) {
-            throw new Error(result.content[0].text);
-        }
-        
-        // Return the content
-        return result;
+    // If the handler returns an error response, throw it
+    if (result.isError) {
+      throw new Error(result.content[0].text);
     }
+
+    // Return the content
+    return result;
+  }
 }

package/src/handlers/analysis/FindByComponentToolHandler.js

@@ -1,5 +1,8 @@
 import { BaseToolHandler } from '../base/BaseToolHandler.js';
-import { findByComponentToolDefinition, findByComponentHandler } from '../../tools/analysis/findByComponent.js';
+import {
+  findByComponentToolDefinition,
+  findByComponentHandler
+} from '../../tools/analysis/findByComponent.js';
 
 /**
  * Handler for the analysis_component_find tool

package/src/handlers/analysis/GetAnimatorStateToolHandler.js

@@ -1,9 +1,9 @@
 import { BaseToolHandler } from '../base/BaseToolHandler.js';
-import { 
-    getAnimatorStateToolDefinition,
-    getAnimatorRuntimeInfoToolDefinition,
-    getAnimatorStateHandler,
-    getAnimatorRuntimeInfoHandler
+import {
+  getAnimatorStateToolDefinition,
+  getAnimatorRuntimeInfoToolDefinition,
+  getAnimatorStateHandler,
+  getAnimatorRuntimeInfoHandler
 } from '../../tools/analysis/getAnimatorState.js';
 
 export class GetAnimatorStateToolHandler extends BaseToolHandler {

package/src/handlers/analysis/GetComponentValuesToolHandler.js

@@ -1,5 +1,8 @@
 import { BaseToolHandler } from '../base/BaseToolHandler.js';
-import { getComponentValuesToolDefinition, getComponentValuesHandler } from '../../tools/analysis/getComponentValues.js';
+import {
+  getComponentValuesToolDefinition,
+  getComponentValuesHandler
+} from '../../tools/analysis/getComponentValues.js';
 
 /**
  * Handler for the analysis_component_values_get tool

package/src/handlers/analysis/GetGameObjectDetailsToolHandler.js

@@ -1,35 +1,38 @@
 import { BaseToolHandler } from '../base/BaseToolHandler.js';
-import { getGameObjectDetailsToolDefinition, getGameObjectDetailsHandler } from '../../tools/analysis/getGameObjectDetails.js';
+import {
+  getGameObjectDetailsToolDefinition,
+  getGameObjectDetailsHandler
+} from '../../tools/analysis/getGameObjectDetails.js';
 
 /**
  * Handler for get_gameobject_details tool
  */
 export class GetGameObjectDetailsToolHandler extends BaseToolHandler {
-    constructor(unityConnection) {
-        super(
-            getGameObjectDetailsToolDefinition.name,
-            getGameObjectDetailsToolDefinition.description,
-            getGameObjectDetailsToolDefinition.inputSchema
-        );
-        this.unityConnection = unityConnection;
-        this.handler = getGameObjectDetailsHandler;
+  constructor(unityConnection) {
+    super(
+      getGameObjectDetailsToolDefinition.name,
+      getGameObjectDetailsToolDefinition.description,
+      getGameObjectDetailsToolDefinition.inputSchema
+    );
+    this.unityConnection = unityConnection;
+    this.handler = getGameObjectDetailsHandler;
+  }
+
+  async execute(args) {
+    // Check connection
+    if (!this.unityConnection.isConnected()) {
+      throw new Error('Unity connection not available');
     }
 
-    async execute(args) {
-        // Check connection
-        if (!this.unityConnection.isConnected()) {
-            throw new Error('Unity connection not available');
-        }
+    // Use the handler function
+    const result = await this.handler(this.unityConnection, args);
 
-        // Use the handler function
-        const result = await this.handler(this.unityConnection, args);
-        
-        // If the handler returns an error response, throw it
-        if (result.isError) {
-            throw new Error(result.content[0].text);
-        }
-        
-        // Return the content
-        return result;
+    // If the handler returns an error response, throw it
+    if (result.isError) {
+      throw new Error(result.content[0].text);
     }
+
+    // Return the content
+    return result;
+  }
 }

package/src/handlers/analysis/GetInputActionsStateToolHandler.js

@@ -1,9 +1,9 @@
 import { BaseToolHandler } from '../base/BaseToolHandler.js';
-import { 
-    getInputActionsStateToolDefinition,
-    analyzeInputActionsAssetToolDefinition,
-    getInputActionsStateHandler,
-    analyzeInputActionsAssetHandler
+import {
+  getInputActionsStateToolDefinition,
+  analyzeInputActionsAssetToolDefinition,
+  getInputActionsStateHandler,
+  analyzeInputActionsAssetHandler
 } from '../../tools/analysis/getInputActionsState.js';
 
 export class GetInputActionsStateToolHandler extends BaseToolHandler {

package/src/handlers/analysis/GetObjectReferencesToolHandler.js

@@ -1,5 +1,8 @@
 import { BaseToolHandler } from '../base/BaseToolHandler.js';
-import { getObjectReferencesToolDefinition, getObjectReferencesHandler } from '../../tools/analysis/getObjectReferences.js';
+import {
+  getObjectReferencesToolDefinition,
+  getObjectReferencesHandler
+} from '../../tools/analysis/getObjectReferences.js';
 
 /**
  * Handler for the analysis_object_references_get tool

package/src/handlers/asset/AssetDatabaseManageToolHandler.js

@@ -13,7 +13,16 @@ export class AssetDatabaseManageToolHandler extends BaseToolHandler {
         properties: {
           action: {
             type: 'string',
-            enum: ['find_assets', 'get_asset_info', 'create_folder', 'delete_asset', 'move_asset', 'copy_asset', 'refresh', 'save'],
+            enum: [
+              'find_assets',
+              'get_asset_info',
+              'create_folder',
+              'delete_asset',
+              'move_asset',
+              'copy_asset',
+              'refresh',
+              'save'
+            ],
             description: 'The action to perform'
           },
           filter: {
@@ -53,7 +62,16 @@ export class AssetDatabaseManageToolHandler extends BaseToolHandler {
       throw new Error('action is required');
     }
 
-    const validActions = ['find_assets', 'get_asset_info', 'create_folder', 'delete_asset', 'move_asset', 'copy_asset', 'refresh', 'save'];
+    const validActions = [
+      'find_assets',
+      'get_asset_info',
+      'create_folder',
+      'delete_asset',
+      'move_asset',
+      'copy_asset',
+      'refresh',
+      'save'
+    ];
     if (!validActions.includes(params.action)) {
       throw new Error(`action must be one of: ${validActions.join(', ')}`);
     }
@@ -123,7 +141,7 @@ export class AssetDatabaseManageToolHandler extends BaseToolHandler {
 
   async execute(params) {
     this.validate(params);
-    
+
     if (!this.unityConnection.isConnected()) {
       await this.unityConnection.connect();
     }
@@ -184,8 +202,8 @@ export class AssetDatabaseManageToolHandler extends BaseToolHandler {
         }
       },
       {
-        input: { 
-          action: 'move_asset', 
+        input: {
+          action: 'move_asset',
           fromPath: 'Assets/icon.png',
           toPath: 'Assets/Textures/icon.png'
         },
@@ -218,4 +236,4 @@ export class AssetDatabaseManageToolHandler extends BaseToolHandler {
       }
     ];
   }
-}
+}

package/src/handlers/asset/AssetDependencyAnalyzeToolHandler.js

@@ -13,7 +13,14 @@ export class AssetDependencyAnalyzeToolHandler extends BaseToolHandler {
         properties: {
           action: {
             type: 'string',
-            enum: ['get_dependencies', 'get_dependents', 'analyze_circular', 'find_unused', 'analyze_size_impact', 'validate_references'],
+            enum: [
+              'get_dependencies',
+              'get_dependents',
+              'analyze_circular',
+              'find_unused',
+              'analyze_size_impact',
+              'validate_references'
+            ],
             description: 'The analysis action to perform'
           },
           assetPath: {
@@ -40,7 +47,14 @@ export class AssetDependencyAnalyzeToolHandler extends BaseToolHandler {
       throw new Error('action is required');
     }
 
-    const validActions = ['get_dependencies', 'get_dependents', 'analyze_circular', 'find_unused', 'analyze_size_impact', 'validate_references'];
+    const validActions = [
+      'get_dependencies',
+      'get_dependents',
+      'analyze_circular',
+      'find_unused',
+      'analyze_size_impact',
+      'validate_references'
+    ];
     if (!validActions.includes(params.action)) {
       throw new Error(`action must be one of: ${validActions.join(', ')}`);
     }
@@ -51,11 +65,11 @@ export class AssetDependencyAnalyzeToolHandler extends BaseToolHandler {
       if (params.assetPath === undefined || params.assetPath === null) {
         throw new Error(`assetPath is required for ${params.action} action`);
       }
-      
+
       if (params.assetPath === '') {
         throw new Error('assetPath cannot be empty');
       }
-      
+
       // Validate assetPath starts with "Assets/"
       if (!params.assetPath.startsWith('Assets/')) {
         throw new Error('assetPath must start with "Assets/"');
@@ -65,7 +79,7 @@ export class AssetDependencyAnalyzeToolHandler extends BaseToolHandler {
 
   async execute(params) {
     this.validate(params);
-    
+
     if (!this.unityConnection.isConnected()) {
       await this.unityConnection.connect();
     }
@@ -124,11 +138,7 @@ export class AssetDependencyAnalyzeToolHandler extends BaseToolHandler {
           action: 'analyze_circular',
           circularDependencies: [
             {
-              cycle: [
-                'Assets/Scripts/A.cs',
-                'Assets/Scripts/B.cs',
-                'Assets/Scripts/A.cs'
-              ],
+              cycle: ['Assets/Scripts/A.cs', 'Assets/Scripts/B.cs', 'Assets/Scripts/A.cs'],
               length: 3,
               severity: 'warning'
             }
@@ -198,4 +208,4 @@ export class AssetDependencyAnalyzeToolHandler extends BaseToolHandler {
       }
     ];
   }
-}
+}

package/src/handlers/asset/AssetImportSettingsManageToolHandler.js

@@ -71,7 +71,7 @@ export class AssetImportSettingsManageToolHandler extends BaseToolHandler {
       if (params.preset === undefined || params.preset === null) {
         throw new Error('preset is required for apply_preset action');
       }
-      
+
       if (params.preset === '') {
         throw new Error('preset cannot be empty');
       }
@@ -80,7 +80,7 @@ export class AssetImportSettingsManageToolHandler extends BaseToolHandler {
 
   async execute(params) {
     this.validate(params);
-    
+
     if (!this.unityConnection.isConnected()) {
       await this.unityConnection.connect();
     }
@@ -112,8 +112,8 @@ export class AssetImportSettingsManageToolHandler extends BaseToolHandler {
         }
       },
       {
-        input: { 
-          action: 'modify', 
+        input: {
+          action: 'modify',
           assetPath: 'Assets/Textures/icon.png',
           settings: {
             maxTextureSize: 1024,
@@ -136,8 +136,8 @@ export class AssetImportSettingsManageToolHandler extends BaseToolHandler {
         }
       },
       {
-        input: { 
-          action: 'apply_preset', 
+        input: {
+          action: 'apply_preset',
           assetPath: 'Assets/Textures/icon.png',
           preset: 'UI_Sprite'
         },
@@ -167,4 +167,4 @@ export class AssetImportSettingsManageToolHandler extends BaseToolHandler {
       }
     ];
   }
-}
+}