MCP Server for Unity

Instructions

Implementation Reference

• src/tools/unity-mcp-tools.ts:525-539 (handler)

  Handler for the 'folder_list' tool. Calls the adapter's listFolder method with provided path and recursive parameters, then formats the directory entries with icons (📁 for folders, 📄 for files) and path information, returning a formatted text response.

  case 'folder_list': {
    const result = await this.adapter.listFolder(args.path, args.recursive);
    const entries = result.entries.map(e => {
      const prefix = e.type === 'folder' ? '📁' : '📄';
      const info = e.type === 'file' ? ` (${e.extension})` : '';
      return `${prefix} ${e.name}${info} - ${e.path}`;
    }).join('\n');
    
    return {
      content: [{
        type: 'text',
        text: `Contents of ${result.path}:\n\n${entries || '(empty)'}`
      }]
    };
  }

• src/tools/unity-mcp-tools.ts:300-316 (registration)

  Registration of the 'folder_list' tool in the getTools() method, including name, description, and input schema definition.

  {
    name: 'folder_list',
    description: 'List contents of a folder in Unity project',
    inputSchema: {
      type: 'object',
      properties: {
        path: {
          type: 'string',
          description: 'Path of the folder to list (default: Assets)'
        },
        recursive: {
          type: 'boolean',
          description: 'List all subdirectories recursively (default: false)'
        }
      }
    }
  }

• src/tools/unity-mcp-tools.ts:303-316 (schema)

  Input schema for the folder_list tool defining parameters: path (string, optional, default Assets) and recursive (boolean, optional, default false).

    inputSchema: {
      type: 'object',
      properties: {
        path: {
          type: 'string',
          description: 'Path of the folder to list (default: Assets)'
        },
        recursive: {
          type: 'boolean',
          description: 'List all subdirectories recursively (default: false)'
        }
      }
    }
  }

• src/adapters/unity-http-adapter.ts:169-171 (helper)

  Helper method in UnityHttpAdapter that implements listFolder by making an HTTP POST call to Unity server endpoint 'folder/list' with path and recursive parameters.

  async listFolder(path?: string, recursive: boolean = false): Promise<{ path: string; entries: FolderEntry[] }> {
    return this.call('folder/list', { path, recursive });
  }

• src/adapters/unity-http-adapter.ts:14-20 (helper)

  Type definition for FolderEntry used in listFolder response, defining structure of directory listing entries.

  export interface FolderEntry {
    path: string;
    name: string;
    type: 'file' | 'folder';
    extension?: string;
    guid: string;
  }