Strudel MCP Server

Instructions

Implementation Reference

• src/server/EnhancedMCPServerFixed.ts:75-79 (registration)

  Registration of the 'init' tool in the getTools() method, including name, description, and empty input schema (no parameters required).
  { name: 'init', description: 'Initialize Strudel in browser', inputSchema: { type: 'object', properties: {} } },
• src/server/EnhancedMCPServerFixed.ts:78-78 (schema)

  Input schema for 'init' tool: empty object, no input parameters required.
  inputSchema: { type: 'object', properties: {} }
• src/server/EnhancedMCPServerFixed.ts:692-704 (handler)

  Handler implementation in executeTool switch statement: calls StrudelController.initialize(), sets isInitialized=true, and writes any pending generated patterns.
  case 'init': const initResult = await this.controller.initialize(); this.isInitialized = true; // Write any pending patterns if (this.generatedPatterns.size > 0) { const lastPattern = Array.from(this.generatedPatterns.values()).pop(); if (lastPattern) { await this.controller.writePattern(lastPattern); return `${initResult}. Loaded generated pattern.`; } } return initResult;
• src/StrudelController.ts:42-92 (helper)

  Core initialization logic delegated by MCP handler: launches headless Chromium browser, navigates to strudel.cc, optimizes loading, sets up console monitoring and audio analyzer.
  async initialize(): Promise<string> { if (this.browser) { return 'Already initialized'; } this.browser = await chromium.launch({ headless: this.isHeadless, args: [ '--use-fake-ui-for-media-stream', '--disable-dev-shm-usage', '--no-sandbox', '--disable-setuid-sandbox', '--disable-gpu', '--disable-software-rasterizer' ], }); const context = await this.browser.newContext({ permissions: ['microphone'], viewport: { width: 1280, height: 720 }, reducedMotion: 'reduce', }); this._page = await context.newPage(); // Optimize page loading await this._page.route('**/*', (route) => { const resourceType = route.request().resourceType(); // Block unnecessary resources if (['image', 'font', 'media'].includes(resourceType)) { route.abort(); } else { route.continue(); } }); await this._page.goto('https://strudel.cc/', { waitUntil: 'domcontentloaded', // Changed from networkidle for faster load timeout: 15000, }); // Wait for editor with optimized timeout await this._page.waitForSelector('.cm-content', { timeout: 8000 }); // Set up console monitoring for runtime errors this.setupConsoleMonitoring(); await this.analyzer.inject(this._page); return 'Strudel initialized successfully'; }
• src/server/EnhancedMCPServerFixed.ts:46-46 (helper)

  State flag tracking whether the browser has been initialized by the 'init' tool.
  private isInitialized: boolean = false;