_ _ _ _
__| |(_) ___ | | __ _ _ _ __| | ___
/ _` || | / __| | | / _` || | | |/ _` | / _ \
| (_| || | _ | (__ | || (_| || |_| | (_| || __/
\__,_|| | (_) \___| |_| \__,_| \__,_|\__,_| \___|
_/ |
|__/
DJ Claude
The live music engine for AI agents.
About
DJ Claude is the only music MCP server with multi-agent collaboration. Multiple AI agents connect over HTTP and jam together in real-time — one adds drums, another layers bass, a third drops a melody — and everything composes automatically. It works in your terminal, browser, or as a Claude Code plugin with slash commands. No browser tab, no API key, no external services required.
Under the hood, DJ Claude uses Strudel — a live coding environment for music — to generate and play patterns in real time. 20 MCP tools, 3 resources, conductor mode, mix snapshots, 22 presets, and 8 vibes. Agents can make music for you, themselves, and each other while they work.
Why DJ Claude?
- Multi-agent jam sessions — the first music MCP where multiple agents connect over HTTP and build music together in real-time, each adding layers that compose automatically
- Zero dependencies — no browser tab, no API key, no external services. Every tool works out of the box
- Claude Code plugin — one-step install from the marketplace with 20 slash commands
- Conductor mode — orchestrate a full band from a single directive, with auto-detected templates (jazz combo, rock band, electronic, ambient, and more)
- Agent-native — 3 MCP resources teach any connected agent the Strudel language so it can compose original music, not just pick from presets
Ways to Play
| Mode | Command | Description |
|---|
| Claude Code plugin | /plugin install dj-claude | Slash commands + MCP server, one-step install |
| Web app | claude.dj | Single-agent browser experience, no API key needed |
| Terminal TUI | npx dj-claude | Interactive terminal DJ |
| TUI + Web audio | npx dj-claude --browser | TUI with browser audio engine for higher quality sound |
| Headless | npx dj-claude --headless "lofi" | Script and automation friendly, plays and exits (--duration N to set seconds, default 10) |
| MCP server | npx dj-claude-mcp | For AI agent integration (Cursor, Windsurf, Zed, etc.) |
| MCP HTTP server | npx dj-claude-mcp-http | Multi-agent jam sessions over HTTP |
Terminal audio vs. browser audio: By default, the CLI and MCP server render audio through node-web-audio-api — a Node.js reimplementation of the Web Audio API. It works everywhere with zero setup, but sample playback and effects can sound rougher than a real browser engine. Add --browser (CLI) or set DJ_CLAUDE_BROWSER=1 (MCP) to route audio through your system browser's native Web Audio instead. This opens a background tab and produces noticeably higher quality sound — especially for pads, reverb, and layered patterns.
Quick Start
Prerequisites
- Node.js >= 18
- Anthropic API key — optional. Enables AI-generated music from text prompts. Without it, every tool still works via presets, direct Strudel code, or the
code/layers parameters
Install & Run
# Set your API key (or add to a .env file)
export ANTHROPIC_API_KEY=sk-ant-...
# Launch the terminal DJ
npx dj-claude
Or install globally:
npm i -g dj-claude
dj-claude
Or go headless for scripting:
npx dj-claude --headless "jazzy lo-fi beats" --duration 30
Claude Code Plugin
The easiest way to use DJ Claude with Claude Code. Installs the MCP server and gives you slash commands.
Install
/plugin marketplace add p-poss/dj-claude
/plugin install dj-claude@dj-claude-marketplace
Slash Commands
