@akiojin/unity-mcp-server 2.32.0 → 2.37.0

package/src/core/transports/HybridStdioServerTransport.js

@@ -1,178 +1,181 @@
-import process from 'node:process'
-import { JSONRPCMessageSchema } from '@modelcontextprotocol/sdk/types.js'
+import process from 'node:process';
+import { JSONRPCMessageSchema } from '@modelcontextprotocol/sdk/types.js';
 
-const HEADER_END = '\r\n\r\n'
-const HEADER_RE = /Content-Length:\s*(\d+)/i
-const DEFAULT_BUFFER = Buffer.alloc(0)
+const HEADER_END = '\r\n\r\n';
+const HEADER_RE = /Content-Length:\s*(\d+)/i;
+const DEFAULT_BUFFER = Buffer.alloc(0);
 
 function encodeContentLength(message) {
-  const json = JSON.stringify(message)
-  const header = `Content-Length: ${Buffer.byteLength(json, 'utf8')}${HEADER_END}`
-  return header + json
+  const json = JSON.stringify(message);
+  const header = `Content-Length: ${Buffer.byteLength(json, 'utf8')}${HEADER_END}`;
+  return header + json;
 }
 
 function encodeNdjson(message) {
-  return `${JSON.stringify(message)}\n`
+  return `${JSON.stringify(message)}\n`;
 }
 
 function parseJson(text) {
-  return JSONRPCMessageSchema.parse(JSON.parse(text))
+  return JSONRPCMessageSchema.parse(JSON.parse(text));
 }
 
 export class HybridStdioServerTransport {
   constructor(stdin = process.stdin, stdout = process.stdout) {
-    this._stdin = stdin
-    this._stdout = stdout
-    this._buffer = DEFAULT_BUFFER
-    this._started = false
-    this._mode = null // 'content-length' | 'ndjson'
+    this._stdin = stdin;
+    this._stdout = stdout;
+    this._buffer = DEFAULT_BUFFER;
+    this._started = false;
+    this._mode = null; // 'content-length' | 'ndjson'
 
     this._onData = chunk => {
-      this._buffer = this._buffer.length ? Buffer.concat([this._buffer, chunk]) : Buffer.from(chunk)
-      this._processBuffer()
-    }
+      this._buffer = this._buffer.length
+        ? Buffer.concat([this._buffer, chunk])
+        : Buffer.from(chunk);
+      this._processBuffer();
+    };
 
     this._onError = error => {
-      this.onerror?.(error)
-    }
+      this.onerror?.(error);
+    };
   }
 
   get framingMode() {
-    return this._mode
+    return this._mode;
   }
 
   async start() {
     if (this._started) {
-      throw new Error('HybridStdioServerTransport already started')
+      throw new Error('HybridStdioServerTransport already started');
     }
-    this._started = true
-    this._stdin.on('data', this._onData)
-    this._stdin.on('error', this._onError)
+    this._started = true;
+    this._stdin.on('data', this._onData);
+    this._stdin.on('error', this._onError);
   }
 
   async close() {
-    if (!this._started) return
-    this._stdin.off('data', this._onData)
-    this._stdin.off('error', this._onError)
-    this._buffer = DEFAULT_BUFFER
-    this._started = false
-    this.onclose?.()
+    if (!this._started) return;
+    this._stdin.off('data', this._onData);
+    this._stdin.off('error', this._onError);
+    this._buffer = DEFAULT_BUFFER;
+    this._started = false;
+    this.onclose?.();
   }
 
   send(message) {
     return new Promise(resolve => {
-      const payload = this._mode === 'ndjson' ? encodeNdjson(message) : encodeContentLength(message)
+      const payload =
+        this._mode === 'ndjson' ? encodeNdjson(message) : encodeContentLength(message);
       if (this._stdout.write(payload)) {
-        resolve()
+        resolve();
       } else {
-        this._stdout.once('drain', resolve)
+        this._stdout.once('drain', resolve);
       }
-    })
+    });
   }
 
   _processBuffer() {
     while (true) {
-      const message = this._readMessage()
+      const message = this._readMessage();
       if (message === null) {
-        break
+        break;
       }
-      this.onmessage?.(message)
+      this.onmessage?.(message);
     }
   }
 
   _readMessage() {
     if (!this._buffer || this._buffer.length === 0) {
-      return null
+      return null;
     }
 
     if (this._mode === 'content-length') {
-      return this._readContentLengthMessage()
+      return this._readContentLengthMessage();
     }
     if (this._mode === 'ndjson') {
-      return this._readNdjsonMessage()
+      return this._readNdjsonMessage();
     }
 
-    const prefix = this._peekPrefix()
+    const prefix = this._peekPrefix();
     if (!prefix.length) {
-      return null
+      return null;
     }
 
     if ('content-length:'.startsWith(prefix.toLowerCase())) {
-      return null // Wait for full header keyword before deciding
+      return null; // Wait for full header keyword before deciding
     }
 
     if (prefix.toLowerCase().startsWith('content-length:')) {
-      this._mode = 'content-length'
-      return this._readContentLengthMessage()
+      this._mode = 'content-length';
+      return this._readContentLengthMessage();
     }
 
-    const newlineIndex = this._buffer.indexOf(0x0a) // '\n'
+    const newlineIndex = this._buffer.indexOf(0x0a); // '\n'
     if (newlineIndex === -1) {
-      return null
+      return null;
     }
 
-    this._mode = 'ndjson'
-    return this._readNdjsonMessage()
+    this._mode = 'ndjson';
+    return this._readNdjsonMessage();
   }
 
   _peekPrefix() {
-    const length = Math.min(this._buffer.length, 32)
-    return this._buffer.toString('utf8', 0, length).trimStart()
+    const length = Math.min(this._buffer.length, 32);
+    return this._buffer.toString('utf8', 0, length).trimStart();
   }
 
   _readContentLengthMessage() {
-    const headerEndIndex = this._buffer.indexOf(HEADER_END)
+    const headerEndIndex = this._buffer.indexOf(HEADER_END);
     if (headerEndIndex === -1) {
-      return null
+      return null;
     }
 
-    const header = this._buffer.toString('utf8', 0, headerEndIndex)
-    const match = header.match(HEADER_RE)
+    const header = this._buffer.toString('utf8', 0, headerEndIndex);
+    const match = header.match(HEADER_RE);
     if (!match) {
-      this._buffer = this._buffer.subarray(headerEndIndex + HEADER_END.length)
-      this.onerror?.(new Error('Invalid Content-Length header'))
-      return null
+      this._buffer = this._buffer.subarray(headerEndIndex + HEADER_END.length);
+      this.onerror?.(new Error('Invalid Content-Length header'));
+      return null;
     }
 
-    const length = Number(match[1])
-    const totalMessageLength = headerEndIndex + HEADER_END.length + length
+    const length = Number(match[1]);
+    const totalMessageLength = headerEndIndex + HEADER_END.length + length;
     if (this._buffer.length < totalMessageLength) {
-      return null
+      return null;
     }
 
     const json = this._buffer.toString(
       'utf8',
       headerEndIndex + HEADER_END.length,
       totalMessageLength
-    )
-    this._buffer = this._buffer.subarray(totalMessageLength)
+    );
+    this._buffer = this._buffer.subarray(totalMessageLength);
 
     try {
-      return parseJson(json)
+      return parseJson(json);
     } catch (error) {
-      this.onerror?.(error)
-      return null
+      this.onerror?.(error);
+      return null;
     }
   }
 
   _readNdjsonMessage() {
     while (true) {
-      const newlineIndex = this._buffer.indexOf(0x0a)
+      const newlineIndex = this._buffer.indexOf(0x0a);
       if (newlineIndex === -1) {
-        return null
+        return null;
       }
 
-      let line = this._buffer.toString('utf8', 0, newlineIndex)
-      this._buffer = this._buffer.subarray(newlineIndex + 1)
-      line = line.trim()
+      let line = this._buffer.toString('utf8', 0, newlineIndex);
+      this._buffer = this._buffer.subarray(newlineIndex + 1);
+      line = line.trim();
       if (!line) {
-        continue
+        continue;
       }
 
       try {
-        return parseJson(line)
+        return parseJson(line);
       } catch (error) {
-        this.onerror?.(error)
+        this.onerror?.(error);
       }
     }
   }

package/src/handlers/addressables/AddressablesAnalyzeToolHandler.js

@@ -1,4 +1,4 @@
-import { BaseToolHandler } from '../base/BaseToolHandler.js'
+import { BaseToolHandler } from '../base/BaseToolHandler.js';
 
 /**
  * Addressables Analysis Tool Handler for Unity MCP
@@ -38,51 +38,51 @@ export default class AddressablesAnalyzeToolHandler extends BaseToolHandler {
         },
         required: ['action']
       }
-    )
-    this.unityConnection = unityConnection
+    );
+    this.unityConnection = unityConnection;
   }
 
   validate(params) {
-    const { action, assetPath } = params || {}
+    const { action, assetPath } = params || {};
 
     if (!action) {
-      throw new Error('action is required')
+      throw new Error('action is required');
     }
 
-    const validActions = ['analyze_duplicates', 'analyze_dependencies', 'analyze_unused']
+    const validActions = ['analyze_duplicates', 'analyze_dependencies', 'analyze_unused'];
     if (!validActions.includes(action)) {
-      throw new Error(`Invalid action: ${action}. Must be one of: ${validActions.join(', ')}`)
+      throw new Error(`Invalid action: ${action}. Must be one of: ${validActions.join(', ')}`);
     }
 
     // Action-specific validation
     if (action === 'analyze_dependencies' && !assetPath) {
-      throw new Error('assetPath is required for analyze_dependencies')
+      throw new Error('assetPath is required for analyze_dependencies');
     }
   }
 
   async execute(params) {
-    const { action, ...parameters } = params
+    const { action, ...parameters } = params;
 
     // Ensure connected
     if (!this.unityConnection.isConnected()) {
-      await this.unityConnection.connect()
+      await this.unityConnection.connect();
     }
 
     const result = await this.unityConnection.sendCommand('addressables_analyze', {
       action,
       ...parameters
-    })
+    });
 
-    return this.formatResponse(action, result)
+    return this.formatResponse(action, result);
   }
 
   formatResponse(action, result) {
     if (result && result.error) {
-      throw new Error(result.error.message || result.error)
+      throw new Error(result.error.message || result.error);
     }
 
     if (!result || typeof result !== 'object') {
-      throw new Error('Invalid response from Unity')
+      throw new Error('Invalid response from Unity');
     }
 
     // Return formatted response
@@ -93,88 +93,86 @@ export default class AddressablesAnalyzeToolHandler extends BaseToolHandler {
           text: this.formatResultText(action, result)
         }
       ]
-    }
+    };
   }
 
   formatResultText(action, result) {
-    const lines = []
+    const lines = [];
 
     switch (action) {
       case 'analyze_duplicates':
-        lines.push('🔍 重複アセット分析結果')
+        lines.push('🔍 重複アセット分析結果');
         if (result.data && result.data.duplicates) {
           if (result.data.duplicates.length === 0) {
-            lines.push('  ✅ 重複アセットは見つかりませんでした')
+            lines.push('  ✅ 重複アセットは見つかりませんでした');
           } else {
-            lines.push(`  ⚠️  重複アセット: ${result.pagination.total}件`)
+            lines.push(`  ⚠️  重複アセット: ${result.pagination.total}件`);
             result.data.duplicates.forEach(dup => {
-              lines.push(`\n  📁 ${dup.assetPath}`)
-              lines.push(`     使用グループ: ${dup.groups.join(', ')}`)
-            })
+              lines.push(`\n  📁 ${dup.assetPath}`);
+              lines.push(`     使用グループ: ${dup.groups.join(', ')}`);
+            });
             if (result.pagination.hasMore) {
               lines.push(
                 `\n  ... さらに${result.pagination.total - result.pagination.offset - result.pagination.pageSize}件あります`
-              )
+              );
             }
           }
         }
-        break
+        break;
 
       case 'analyze_dependencies':
-        lines.push('🔍 依存関係分析結果')
+        lines.push('🔍 依存関係分析結果');
         if (result.data && result.data.dependencies) {
-          const deps = Object.entries(result.data.dependencies)
+          const deps = Object.entries(result.data.dependencies);
           if (deps.length === 0) {
-            lines.push('  ✅ 依存関係がありません')
+            lines.push('  ✅ 依存関係がありません');
           } else {
             deps.forEach(([assetPath, dependencies]) => {
-              lines.push(`\n  📁 ${assetPath}`)
+              lines.push(`\n  📁 ${assetPath}`);
               if (dependencies.length === 0) {
-                lines.push('     依存なし')
+                lines.push('     依存なし');
               } else {
-                lines.push(`     依存数: ${dependencies.length}個`)
+                lines.push(`     依存数: ${dependencies.length}個`);
                 dependencies.forEach((dep, idx) => {
                   if (idx < 10) {
-                    lines.push(`       → ${dep}`)
+                    lines.push(`       → ${dep}`);
                   }
-                })
+                });
                 if (dependencies.length > 10) {
-                  lines.push(`       ... 他${dependencies.length - 10}件`)
+                  lines.push(`       ... 他${dependencies.length - 10}件`);
                 }
               }
-            })
+            });
           }
         }
-        break
+        break;
 
       case 'analyze_unused':
-        lines.push('🔍 未使用アセット分析結果')
+        lines.push('🔍 未使用アセット分析結果');
         if (result.data && result.data.unused) {
           if (result.data.unused.length === 0) {
-            lines.push('  ✅ すべてのアセットが使用されています')
+            lines.push('  ✅ すべてのアセットが使用されています');
           } else {
-            lines.push(`  ⚠️  未使用アセット: ${result.pagination.total}件`)
+            lines.push(`  ⚠️  未使用アセット: ${result.pagination.total}件`);
             result.data.unused.forEach(path => {
-              lines.push(`    📁 ${path}`)
-            })
+              lines.push(`    📁 ${path}`);
+            });
             if (result.pagination.hasMore) {
               lines.push(
                 `\n  ... さらに${result.pagination.total - result.pagination.offset - result.pagination.pageSize}件あります`
-              )
+              );
             }
             lines.push(
               '\n  💡 これらのアセットはAddressableとして登録されておらず、他のAddressableからも参照されていません'
-            )
+            );
           }
         }
-        break
+        break;
 
       default:
-        lines.push(JSON.stringify(result, null, 2))
+        lines.push(JSON.stringify(result, null, 2));
     }
 
-    return lines.join('\n')
+    return lines.join('\n');
   }
 }
-
-

package/src/handlers/addressables/AddressablesBuildToolHandler.js

@@ -1,4 +1,4 @@
-import { BaseToolHandler } from '../base/BaseToolHandler.js'
+import { BaseToolHandler } from '../base/BaseToolHandler.js';
 
 /**
  * Addressables Build Tool Handler for Unity MCP
@@ -29,20 +29,20 @@ export default class AddressablesBuildToolHandler extends BaseToolHandler {
         }
       },
       required: ['action']
-    })
-    this.unityConnection = unityConnection
+    });
+    this.unityConnection = unityConnection;
   }
 
   validate(params) {
-    const { action, buildTarget } = params || {}
+    const { action, buildTarget } = params || {};
 
     if (!action) {
-      throw new Error('action is required')
+      throw new Error('action is required');
     }
 
-    const validActions = ['build', 'clean_build']
+    const validActions = ['build', 'clean_build'];
     if (!validActions.includes(action)) {
-      throw new Error(`Invalid action: ${action}. Must be one of: ${validActions.join(', ')}`)
+      throw new Error(`Invalid action: ${action}. Must be one of: ${validActions.join(', ')}`);
     }
 
     if (buildTarget) {
@@ -54,25 +54,25 @@ export default class AddressablesBuildToolHandler extends BaseToolHandler {
         'iOS',
         'Android',
         'WebGL'
-      ]
+      ];
       if (!validTargets.includes(buildTarget)) {
         throw new Error(
           `Invalid buildTarget: ${buildTarget}. Must be one of: ${validTargets.join(', ')}`
-        )
+        );
       }
     }
   }
 
   async execute(params) {
-    const { action, ...parameters } = params
+    const { action, ...parameters } = params;
 
     // Ensure connected
     if (!this.unityConnection.isConnected()) {
-      await this.unityConnection.connect()
+      await this.unityConnection.connect();
     }
 
     // Build operations can take several minutes
-    const timeout = 300000 // 5 minutes
+    const timeout = 300000; // 5 minutes
 
     const result = await this.unityConnection.sendCommand(
       'addressables_build',
@@ -81,18 +81,18 @@ export default class AddressablesBuildToolHandler extends BaseToolHandler {
         ...parameters
       },
       timeout
-    )
+    );
 
-    return this.formatResponse(action, result)
+    return this.formatResponse(action, result);
   }
 
   formatResponse(action, result) {
     if (result && result.error) {
-      throw new Error(result.error.message || result.error)
+      throw new Error(result.error.message || result.error);
     }
 
     if (!result || typeof result !== 'object') {
-      throw new Error('Invalid response from Unity')
+      throw new Error('Invalid response from Unity');
     }
 
     // Return formatted response
@@ -103,44 +103,43 @@ export default class AddressablesBuildToolHandler extends BaseToolHandler {
           text: this.formatResultText(action, result)
         }
       ]
-    }
+    };
   }
 
   formatResultText(action, result) {
-    const lines = []
+    const lines = [];
 
     switch (action) {
       case 'build':
         if (result.data) {
           if (result.data.success) {
-            lines.push('✅ Addressablesビルドが成功しました')
-            lines.push(`  ⏱️  所要時間: ${result.data.duration.toFixed(2)}秒`)
+            lines.push('✅ Addressablesビルドが成功しました');
+            lines.push(`  ⏱️  所要時間: ${result.data.duration.toFixed(2)}秒`);
             if (result.data.outputPath) {
-              lines.push(`  📁 出力先: ${result.data.outputPath}`)
+              lines.push(`  📁 出力先: ${result.data.outputPath}`);
             }
           } else {
-            lines.push('❌ Addressablesビルドが失敗しました')
-            lines.push(`  ⏱️  所要時間: ${result.data.duration.toFixed(2)}秒`)
+            lines.push('❌ Addressablesビルドが失敗しました');
+            lines.push(`  ⏱️  所要時間: ${result.data.duration.toFixed(2)}秒`);
             if (result.data.errors && result.data.errors.length > 0) {
-              lines.push('\n  エラー:')
+              lines.push('\n  エラー:');
               result.data.errors.forEach(error => {
-                lines.push(`    ❌ ${error}`)
-              })
+                lines.push(`    ❌ ${error}`);
+              });
             }
           }
         }
-        break
+        break;
 
       case 'clean_build':
-        lines.push(`✅ ${result.message}`)
-        lines.push('  ビルドキャッシュをクリアしました。次回ビルドは完全ビルドになります。')
-        break
+        lines.push(`✅ ${result.message}`);
+        lines.push('  ビルドキャッシュをクリアしました。次回ビルドは完全ビルドになります。');
+        break;
 
       default:
-        lines.push(JSON.stringify(result, null, 2))
+        lines.push(JSON.stringify(result, null, 2));
     }
 
-    return lines.join('\n')
+    return lines.join('\n');
   }
 }
-