@akiojin/unity-editor-mcp/src/handlers/scene/ListScenesToolHandler.js

MCP server for Unity Editor integration - enables AI assistants to control Unity Editor

import { BaseToolHandler } from '../base/BaseToolHandler.js';

/**
 * Handler for listing scenes in Unity
 */
export class ListScenesToolHandler extends BaseToolHandler {
  constructor(unityConnection) {
    super(
      'list_scenes',
      'List scenes in project (filter to loaded/build scenes or by path).',
      {
        type: 'object',
        properties: {
          includeLoadedOnly: {
            type: 'boolean',
            description: 'Only include currently loaded scenes (default: false)'
          },
          includeBuildScenesOnly: {
            type: 'boolean',
            description: 'Only include scenes in build settings (default: false)'
          },
          includePath: {
            type: 'string',
            description: 'Filter scenes by path pattern (e.g., "Levels" to find scenes in Levels folder)'
          }
        },
        required: []
      }
    );
    this.unityConnection = unityConnection;
  }

  /**
   * Executes the list scenes command
   * @param {object} params - Validated input parameters
   * @returns {Promise<object>} List result
   */
  async execute(params) {
    // Ensure connected
    if (!this.unityConnection.isConnected()) {
      throw new Error('Unity connection not available');
    }
    
    // Send command to Unity
    const result = await this.unityConnection.sendCommand('list_scenes', params);
    
    // The unityConnection.sendCommand already extracts the result field
    // Check for Unity-side errors
    if (result && result.error) {
      const error = new Error(result.error);
      error.code = 'UNITY_ERROR';
      throw error;
    }
    
    // Return the result directly since it's already unwrapped
    return result;
  }
}