# strudel-mcp-server

> A Model Context Protocol (MCP) server that gives Claude direct control over Strudel.cc for AI-assisted music generation and live coding.

- **URL**: https://www.freshcrate.ai/projects/strudel-mcp-server
- **Author**: williamzujkowski
- **Category**: MCP Servers
- **Latest version**: `v4.0.0` (2026-05-15)
- **License**: MIT
- **Source**: https://github.com/williamzujkowski/strudel-mcp-server
- **Language**: TypeScript
- **GitHub**: 193 stars, 24 forks
- **Registry**: github
- **Tags**: `typescript`

## Description

A Model Context Protocol (MCP) server that gives Claude direct control over Strudel.cc for AI-assisted music generation and live coding.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v4.0.0` | 2026-05-15 | High | **Breaking change.** The 58 deprecated tool aliases left by the #120 consolidation (shipped in v3.0.0) are removed now that their deprecation window — the entire `3.0.x` line — has closed. `tools/list` drops from **84 → 26**.  ### Breaking  Every removed alias maps to a consolidated tool:  - `write`/`append`/`insert`/`replace`/`clear` → `edit_pattern({ mode })` - `play`/`pause`/`stop` → `playback({ action })` - `save`/`load`/`list` → `pattern_store({ action })` - `status`/`show_errors`/`performa |
| `v3.0.0` | 2026-05-14 | High | ## [3.0.0] — multi-session, MCP resources, result envelope, tool consolidation  The biggest release since the rename. Everything in `2.0.x` still works during a deprecation window, but the protocol-visible response shape changed (see Breaking below).  ### Breaking  - **Result envelope on every `tools/call` response.** Tool responses now wrap their output in a discriminated envelope inside the existing `content[0].text` field:   - Success: `{ "ok": true, "data": ... }` (with optional `"empty": tr |
| `v2.0.0` | 2026-04-20 | High | ## Why  This project imports `@strudel/core`, `@strudel/mini`, `@strudel/tonal`, and `@strudel/transpiler`, all AGPL-3.0 licensed by the upstream [Strudel project](https://codeberg.org/uzu/strudel). Shipping the combined work under MIT (as v1.0.0 and the previous `@williamzujkowski/strudel-mcp-server` package did) was incorrect — AGPL §5 propagates copyleft to anything that combines with AGPL code, and ESM `import` of npm-redistributed packages qualifies as combining. v2.0.0 fixes the license. |
| `v2.4.1` | 2026-02-01 | Low | ## Bug Fixes  - **MCP Protocol**: Fixed stdout pollution from @strudel imports breaking JSON-RPC communication (#85) - **Chord Generation**: Fixed `generateChordProgression()` to produce valid Strudel syntax - `note("<C G Am F>")` instead of invalid `note("C" "G" "Am" "F")` (#85) - **Documentation**: Corrected tool count from 66 to 65, updated test statistics  ## Security  - Bump hono 4.11.4 → 4.11.7 (CVE fixes) (#84)  ## Installation  ```bash npm install -g @williamzujkowski/strudel-mcp-server@ |
| `v2.4.0` | 2026-01-25 | Low | ## What's New in v2.4.0  ### New Features  #### Multi-Session Browser Support (#75) - `SessionManager` for concurrent Strudel sessions with browser context isolation - Max 5 concurrent sessions with 30-minute auto-cleanup timeout - New MCP tools: `create_session`, `destroy_session`, `list_sessions`, `switch_session` - Optional `session_id` parameter on existing tools for session targeting  #### MIDI Export (#74) - `MIDIExportService` for exporting Strudel patterns to standard MIDI files - `expor |
| `v2.3.0` | 2025-12-14 | Low | ## What's New in v2.3.0  ### Pattern History Tools (#41) Browse, restore, and compare pattern versions: - `list_history` - View pattern history with timestamps - `restore_history` - Restore a previous pattern by ID - `compare_patterns` - Line-by-line diff between patterns  ### UX & Browser Tools (#43) Better workflow for music creation: - `compose` - One-shot pattern generation with auto-play - `status` - Quick browser/playback state check - `diagnostics` - Detailed system diagnostics - `show_br |
| `v2.2.0` | 2025-08-18 | Low | # Strudel MCP Server v2.2.0  ## 🎉 Production-Ready Release  This release marks the Strudel MCP Server as **fully production-ready** with comprehensive testing, enhanced features, and verified functionality with real Strudel.cc interaction.  ## ✨ Highlights  ### 🏆 100% Test Coverage - All 40+ tools tested with real Strudel.cc website - 19 integration tests passing (100% success rate) - Browser automation verified working - Audio analysis confirmed functional  ### 🚀 Enhanced Features - **Patter |
| `v1.0.0` | 2025-08-18 | Low | ## 🎉 Initial Release  ### ✨ Features - **MCP Server Implementation**: Complete Model Context Protocol server for Strudel.cc - **Browser Automation**: Control Strudel.cc through Playwright - **Pattern Management**: Write, play, stop, and save patterns - **Audio Analysis**: Real-time frequency analysis and audio feature extraction - **Local Storage**: Save and load patterns with tagging system - **Claude CLI Integration**: Seamless integration with Claude CLI  ### 🛠️ Tools Available - `init` - I |

## Citation

- HTML: https://www.freshcrate.ai/projects/strudel-mcp-server
- Markdown: https://www.freshcrate.ai/projects/strudel-mcp-server.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/strudel-mcp-server/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._