Strudel MCP Server

Instructions

Implementation Reference

• src/server/EnhancedMCPServerFixed.ts:267-270 (registration)

  Registers the 'analyze' MCP tool in the tools list returned by getTools(), including name, description, and input schema (no parameters).
  name: 'analyze', description: 'Complete audio analysis', inputSchema: { type: 'object', properties: {} } },
• src/server/EnhancedMCPServerFixed.ts:950-955 (handler)

  Primary MCP tool handler for 'analyze'. Validates initialization and delegates to StrudelController.analyzeAudio() which performs the actual analysis.
  case 'analyze': if (!this.isInitialized) { return 'Browser not initialized. Run init first.'; } return await this.controller.analyzeAudio();
• src/StrudelController.ts:269-273 (handler)

  Intermediate handler in StrudelController that forwards the analysis request to the AudioAnalyzer instance.
  async analyzeAudio(): Promise<AudioAnalysisResult> { if (!this._page) throw new Error('Browser not initialized. Run init tool first.'); return await this.analyzer.getAnalysis(this._page); }
• src/AudioAnalyzer.ts:179-219 (handler)

  Core analysis handler. Uses page.evaluate to call the injected JavaScript analyzer in the browser, which computes FFT-based features like average, peak, frequency bands, etc. Includes caching.
  async getAnalysis(page: Page): Promise<AudioAnalysisResult> { // Client-side caching with local fallback const now = Date.now(); if (this._analysisCache && (now - this._cacheTimestamp) < this.ANALYSIS_CACHE_TTL) { return this._analysisCache; } const result = await page.evaluate(() => { const analyzer = (window as any).strudelAudioAnalyzer; if (!analyzer) { return { connected: false, error: 'Analyzer not initialized. Audio context may not have started yet.', hint: 'Try playing a pattern first to initialize the audio context.' }; } if (!analyzer.isConnected) { return { connected: false, error: 'Analyzer not connected to audio output.', hint: 'Play a pattern to connect the analyzer to Strudel audio output.' }; } const analysis = analyzer.analyze(); // Add diagnostic info if no audio detected if (analysis.features && analysis.features.isSilent) { analysis.hint = 'Audio analyzer connected but no audio detected. Ensure pattern is playing.'; } return analysis; }); // Update cache this._analysisCache = result; this._cacheTimestamp = now; return result; }
• src/types/AudioAnalysis.ts:56-61 (schema)

  TypeScript interfaces defining the input/output structure for audio analysis results, used throughout the implementation chain.
  export interface AudioAnalysisResult { connected: boolean; timestamp?: number; features?: AudioAnalysisFeatures; error?: string; }