Log inSubmit server
DJ Claude logo

DJ Claude

Live-codes Strudel music for AI agents through presets, prompts, direct code, jam sessions, and mix controls.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install DJ Claude

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "dj-claude": {
      "command": "npx",
      "args": [
        "-y",
        "dj-claude"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "YOUR_VALUE_HERE",
        "DJ_CLAUDE_BROWSER": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y dj-claude

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 3d ago.

Overview

DJ Claude MCP server lets AI agents generate and control live music built with Strudel patterns. Agents can use curated presets, natural-language prompts, or direct Strudel code, then manage layers, evolving mixes, snapshots, and audio output. It supports local MCP use through npx and multi-agent sessions through an HTTP server. Reach for it when an agent should provide adaptive background music, experiment with live-coded patterns, or coordinate a virtual band while development work continues.

Use cases

  • Play adaptive background music while coding
  • Compose Strudel layers with multiple agents
  • Preview and refine jam-session parts
  • Orchestrate a virtual band from a directive
  • Save and restore named mixes

Key features

  • 22 curated music presets
  • Prompt-based and direct Strudel playback
  • Multi-layer jam sessions
  • Live mix and band orchestration
  • Mix analysis and snapshot management
  • Node or browser audio switching

Tools20

What DJ Claude lets your agent do. Expand a tool for its parameters.

Self-reported~310 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

6/6 checks healthy over the last 51d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7h ago via OSV.dev · dj-claude (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars37Stargazers on the source repository.
npm downloads270Package downloads in the last 30 days.
Last commit4mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed20Callable tools this server registers over MCP.

How DJ Claude works

What DJ Claude MCP server does

DJ Claude MCP server gives AI agents tools for creating and managing live-coded music. It uses Strudel, a live coding environment for pattern-based music, and exposes controls for playback, composition, mixing, and session state.

Agents can start with one of 22 curated presets organized around moods, genres, and activities. They can also select a vibe such as chill, dark, hype, focus, funky, dreamy, weird, or epic. For more control, the agent can submit raw Strudel or Tidal code directly, or ask for music from a text prompt when an Anthropic API key is available.

The server also supports layered sessions. An agent can add or update roles such as drums, bass, or melody, preview a layer before adding it, inspect active layers, and remove individual layers or the entire jam. Conductor tools accept a directive or a layer map to arrange a full band and evolve its parts. Mix analysis reports frequency balance, gain information, and suggestions.

How it works

The standard local entry point is npx dj-claude-mcp, which runs as an MCP server for compatible clients. A separate npx dj-claude-mcp-http entry point supports multi-agent jam sessions over HTTP, allowing multiple agents to contribute layers to a shared session in real time.

Audio normally uses the Node Web Audio implementation. The server can switch to a browser-based Web Audio backend during a session, or select it at startup with configuration. The browser option opens a background tab and is intended to improve playback quality for effects, pads, and layered patterns.

AI-generated inputs are optional. Presets, direct Strudel code, and explicit layer definitions work without an API key. Prompt-based generation and directive-based orchestration require ANTHROPIC_API_KEY.

Setup and configuration

Add the server to an MCP client configuration with the npx command and the -y argument. To use browser audio, set DJ_CLAUDE_BROWSER to 1 in the server environment. Node.js 18 or newer is required.

Claude Code users can install the supplied plugin through the DJ Claude marketplace. The plugin adds slash commands for playback, vibes, jam management, analysis, snapshots, export, and HTTP connection setup. MCP permissions may need to be allowed in Claude Code settings if calls should run without repeated approval prompts.

Tools and capabilities

The tool set includes playback controls such as play_preset, play_music, play_strudel, live_mix, hush, and now_playing. Session tools cover jam, jam_clear, jam_status, jam_preview, conduct, and conduct_evolve.

For state and output management, DJ Claude MCP server provides set_context, switch_audio, mix_analysis, snapshot_save, snapshot_load, snapshot_list, and export_code. Context settings let music respond to the activity an agent is working on. Export produces the current Strudel code with header comments, while snapshots save and restore named mixes.

Limitations and notes

Prompt-driven generation depends on an Anthropic API key, but the server remains usable without one through presets and direct code inputs. The default Node audio backend works without a browser but may sound rougher than native browser audio for sample playback and effects.

The HTTP mode is the option intended for multiple agents. Local MCP clients can use the standard server for single-agent control, while multi-agent collaboration requires the HTTP server and its shared session model.

Its export feature returns Strudel code rather than a rendered audio file.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about DJ Claude

DJ Claude is an MCP server that connects AI agents to a live Strudel music engine through stdio or HTTP, with tools for presets, prompted or direct-code playback, jam layers, live mixes, band orchestration, audio switching, snapshots, mix analysis, and code export. It can run without an API key when direct code or preset inputs are used.

Run `npx dj-claude-mcp` from your MCP client configuration. Node.js 18 or newer is required; an Anthropic API key is optional.

Yes, DJ Claude works with Cursor through the standard MCP server configuration. Add the `npx dj-claude-mcp` command to Cursor's MCP settings; use `DJ_CLAUDE_BROWSER=1` if you want to route audio through a browser's Web Audio engine.

Yes, you can use it without an API key through presets, direct Strudel code, and explicit layer or stage definitions. The API key is needed for AI-generated music from prompts and directive-based generation.

Set `DJ_CLAUDE_BROWSER=1` in the MCP server environment. This routes playback through the system browser's native Web Audio engine instead of the default Node implementation and opens a background browser tab.

Related MCP servers

All in Multimedia Process All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewDJ Claude AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/dj-claude?style=directory)](https://allmcps.com/mcp/dj-claude)
HTML Embed
<a href="https://allmcps.com/mcp/dj-claude"><img src="https://allmcps.com/api/badge/dj-claude?style=directory" alt="DJ Claude on AllMCPs" /></a>