Strudel MCP Server

# CLAUDE.md - Strudel MCP Server Development Guide ## Project Overview This is an MCP (Model Context Protocol) server that provides Claude with direct control over Strudel.cc for AI-assisted music generation. ## Key Components 1. **MCP Server** (`src/index.ts`) - Handles MCP protocol and tool registration 2. **Strudel Controller** (`src/StrudelController.ts`) - Browser automation via Playwright 3. **Audio Analyzer** (`src/AudioAnalyzer.ts`) - Real-time audio analysis 4. **Pattern Store** (`src/PatternStore.ts`) - Local pattern storage with tagging ## Development Guidelines - Use TypeScript with strict mode enabled - Follow existing code patterns for consistency - Ensure all browser automation is properly error-handled - Test changes with actual Strudel.cc interaction ## Testing ```bash # Build the project npm run build # Test MCP functionality echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | node dist/index.js # Run in development mode npm run dev ``` ## Adding New Tools To add a new tool: 1. Add tool definition in `setupHandlers()` method 2. Implement handler in the switch statement 3. Add any necessary methods to StrudelController 4. Update README documentation ## Common Issues - **Browser not opening**: Ensure Playwright Chromium is installed - **Audio analysis failing**: Check that audio is actually playing - **Pattern save errors**: Verify patterns directory exists ## Code Quality - Keep functions focused and single-purpose - Add type annotations for all parameters and returns - Handle errors gracefully with meaningful messages - Avoid unnecessary complexity