Strudel MCP Server

🎵 Open source MCP server for AI-powered music generation with Strudel.cc

Status: Actively developed | Experimental | Contributions welcome

<a href="https://glama.ai/mcp/servers/@williamzujkowski/strudel-mcp-server"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@williamzujkowski/strudel-mcp-server/badge" alt="Strudel Server MCP server" /> </a>

An experimental Model Context Protocol (MCP) server that enables Claude to control Strudel.cc for AI-assisted music generation, live coding, and algorithmic composition.

Current State: Functional but under active development. Core features work reliably, but expect rough edges. Test coverage is at 78% with 1470 tests passing (1521 total, 51 skipped). See open issues for known limitations.

Table of Contents

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

✨ Features

🎹 Complete Music Control

• 65 MCP Tools: Comprehensive suite for music creation and manipulation
• Real Browser Automation: Direct control of Strudel.cc through Playwright
• Live Audio Analysis: Real-time frequency analysis via Web Audio API
• Pattern Generation: AI-powered creation across 8+ music genres
• Music Theory Engine: Scales, chords, progressions, euclidean rhythms
• Session Management: Save, load, undo/redo with pattern storage

🔧 Testing & Development Status

• ✅ Test Suite: 1470 tests passing (1521 total, 51 skipped)
• ✅ Code Coverage: 78% statement coverage (goal: 80%)
• ✅ Browser Integration: Works with live Strudel.cc website
• ✅ Audio Analysis: Real-time FFT analysis functional
• ✅ Pattern Generation: Core music generation features working
• ✅ OIDC Publishing: Secure npm publishing with provenance attestation

Not Production-Ready: This is experimental software under active development. Use for exploration and experimentation. Expect breaking changes, bugs, and incomplete features. See CONTRIBUTING.md to help improve it.

🎼 Example Patterns

Explore 17 curated example patterns across 10 genres in patterns/examples/:

• Techno: Hard techno, minimal techno
• House: Deep house, tech house
• Drum & Bass: Liquid, neurofunk
• Ambient: Dark ambient, drone
• Trap: Modern trap, cloud trap
• Jungle: Classic jungle, ragga jungle
• Jazz: Bebop, modal jazz
• Intelligent DnB: Atmospheric, liquid, LTJ Bukem style
• Trip Hop: Portishead, Massive Attack, Flying Lotus style
• Boom Bap: DJ Premier, Alchemist, golden era hip hop

Each example includes pattern code, BPM, key, and description. See patterns/examples/README.md for details.

📦 Installation

Prerequisites

Optional: Docker for containerized deployment.

From npm

npm install -g @williamzujkowski/strudel-mcp-server

# Install browser (required once)
npx playwright install chromium

From Source

# Clone repository
git clone https://github.com/williamzujkowski/strudel-mcp-server.git
cd strudel-mcp-server

# Install dependencies
npm install

# Install Chromium for browser automation
npx playwright install chromium

# Build the project
npm run build

🚀 Quick Reference

Common commands for immediate use:

One-shot workflow:

compose with style: "dnb", key: "Am", bpm: 174, auto_play: true

🎯 Quick Start

1. Add to Claude

# If installed globally
claude mcp add strudel strudel-mcp

# If built from source
claude mcp add strudel node /path/to/strudel-mcp-server/dist/index.js

2. Start Using

claude chat

Then ask Claude:

• "Initialize Strudel and create a techno beat"
• "Generate a jazz chord progression in F major"
• "Create a drum & bass pattern at 174 BPM"

🛠️ Available Tools (65)

Core Control (10 tools)

Pattern Generation & Manipulation (10 tools)

Music Theory (6 tools)

Effects (4 tools)

Session Management (5 tools)

Pattern History (3 tools)

Audio Analysis (6 tools)

UX & Browser Control (6 tools)

Performance (2 tools)

AI Feedback (1 tool)

Note: Requires GEMINI_API_KEY environment variable. Returns pattern complexity, estimated style, strengths, and suggestions.

🎵 Usage Examples

Basic Pattern Creation

Create a Simple Beat

You: Initialize Strudel and create a simple techno beat

Claude: [Initializes browser]
        [Generates and writes pattern]
        [Starts playback]

Pattern created:
setcpm(130)
stack(
  s("bd*4"),
  s("~ cp ~ cp"),
  s("hh*8").gain(0.4)
).gain(0.8)

Generate a Bassline

You: Add a techno bassline in C

Claude: [Generates bassline]
        [Appends to current pattern]

Added: note("c2 c2 c2 c2").s("sawtooth").cutoff(800)

---