live-coding-music-mcp

🎵 MCP server for AI-assisted live-coding music via strudel.cc

Unofficial fan project. Not affiliated with, or endorsed by, the Strudel project. This adapter exists to make live-coding music accessible to beginners who want to try pattern-based music without learning the whole ecosystem first.

Status: Beta | 86% statement coverage | Published to npm | Actively developed

A Model Context Protocol (MCP) server that drives Strudel.cc from Claude for AI-assisted live-coding music, pattern generation, and algorithmic composition.

Current State: Beta. The core workflow (init → compose → playback → analyze) works reliably with real audio output. 1709 tests pass, 86.32% statement coverage / 75.93% branch coverage. CI is hardened with OpenSSF Scorecard, SHA-pinned actions, CODEOWNERS, Dependabot, and lint as a blocking gate.

What "Beta" means here:

• Tool schemas are stable within minor versions; breaking changes require a major bump
• Multi-session is supported as of v3.0.0 (#108) — named sessions get isolated browser, history, and audio-capture state
• Upstream @strudel/* dependencies pinned to known-good versions; Dependabot bumps gated on CI
• Expect hands-on iteration for non-standard patterns — report rough edges, they get fixed

Table of Contents

• Features
• Installation
• Quick Start
• Quick Reference
• Available Tools
• Usage Examples
• Architecture
• Advanced Usage
• Configuration
• Security
• Troubleshooting
• Development
• Contributing

Features

Music control

• 27 MCP tools covering pattern editing, playback, audio analysis, generation, history, sessions, MIDI import/export, and Gemini-backed assists. Each tool is enum-parameterized to keep the protocol surface small: pattern_store({ action }), edit_pattern({ mode }), transform({ op }), analyze({ include }), history({ action }), playback({ action }), effect({ action }), shape({ dimension }), audio_capture({ action }), browser_window({ action }), generate_part({ role }), generate_rhythm({ type }), music_theory({ query }), session({ action }), ai_assist({ task }), ... The 58 legacy single-verb aliases that forwarded to these were removed in v4.0.0 (#178).
• 4 MCP resources for catalog browsing without burning tool calls: strudel://examples, strudel://patterns, strudel://styles, strudel://docs/tools.
• Real browser automation of Strudel.cc through Playwright.
• Multi-session support — every browser-touching tool accepts an optional session_id; sessions have isolated browser pages, undo/redo/history stacks, and audio-capture services.
• Audio analysis via Web Audio API (FFT spectrum, tempo detection,

... View full README on GitHub