Strudel MCP Server

Instructions

Implementation Reference

• src/StrudelController.ts:677-690 (handler)

  Core handler function that executes the screenshot using Puppeteer page.screenshot() and handles filename and errors.

  async takeScreenshot(filename?: string): Promise<string> {
    if (!this._page) {
      throw new Error('Browser not initialized. Run init tool first.');
    }
  
    try {
      const path = filename || `strudel-screenshot-${Date.now()}.png`;
      await this._page.screenshot({ path, fullPage: false });
      return `Screenshot saved to ${path}`;
    } catch (error: any) {
      this.logger.error('Failed to take screenshot', error);
      throw new Error(`Failed to take screenshot: ${error.message}`);
    }
  }

• src/server/EnhancedMCPServerFixed.ts:1208-1213 (handler)

  MCP server dispatch handler for 'screenshot' tool call, which proxies to StrudelController.takeScreenshot after initialization check.

  case 'screenshot':
    if (!this.isInitialized) {
      return 'Browser not initialized. Run init first.';
    }
    return await this.controller.takeScreenshot(args?.filename);

• src/server/EnhancedMCPServerFixed.ts:525-533 (schema)

  Tool schema registration in getTools() array, defining name, description, and optional filename input schema.

    name: 'screenshot',
    description: 'Take a screenshot of the current Strudel editor state',
    inputSchema: {
      type: 'object',
      properties: {
        filename: { type: 'string', description: 'Optional filename for screenshot' }
      }
    }
  },

• src/server/EnhancedMCPServerFixed.ts:524-567 (registration)

  The screenshot tool is registered as part of the tools array returned by getTools(), used for ListTools MCP request.

    {
      name: 'screenshot',
      description: 'Take a screenshot of the current Strudel editor state',
      inputSchema: {
        type: 'object',
        properties: {
          filename: { type: 'string', description: 'Optional filename for screenshot' }
        }
      }
    },
  
    // UX Tools - Status & Diagnostics (#39)
    {
      name: 'status',
      description: 'Get current browser and playback status (quick state check)',
      inputSchema: { type: 'object', properties: {} }
    },
    {
      name: 'diagnostics',
      description: 'Get detailed browser diagnostics including cache, errors, and performance',
      inputSchema: { type: 'object', properties: {} }
    },
    {
      name: 'show_errors',
      description: 'Display captured console errors and warnings from Strudel',
      inputSchema: { type: 'object', properties: {} }
    },
  
    // UX Tools - High-level Compose (#42)
    {
      name: 'compose',
      description: 'Generate, write, and play a complete pattern in one step. Auto-initializes browser if needed.',
      inputSchema: {
        type: 'object',
        properties: {
          style: { type: 'string', description: 'Genre: techno, house, dnb, ambient, trap, jungle, jazz, experimental' },
          tempo: { type: 'number', description: 'BPM (default: genre-appropriate)' },
          key: { type: 'string', description: 'Musical key (default: C)' },
          auto_play: { type: 'boolean', description: 'Start playback immediately (default: true)' }
        },
        required: ['style']
      }
    }
  ];