Claude DJ MCP

An MCP server that lets Claude act as an autonomous radio DJ using Strudel live-coded music.

Features

• 🎵 Live-coded music — Claude generates Strudel patterns in real-time
• 🎙️ DJ announcements — Text-to-speech commentary (macOS)
• 🎚️ Dynamic tempo control — Adjust BPM mid-session
• 📻 Audience requests — Take song/vibe requests from browser UI
• 🔄 Autonomous DJ loop — Play → announce → wait → adapt → repeat

Security Notice

⚠️ This project is designed for local development and personal use only.

Important security considerations:

• Local use only — The HTTP server binds to localhost but has open CORS headers (Access-Control-Allow-Origin: *)
• Code execution — Claude sends arbitrary Strudel code that is evaluated in the browser without sandboxing
• Command execution — The dj_speak tool executes shell commands (macOS say) with user-controlled input
• No authentication — Anyone with access to localhost can interact with active sessions
• No rate limiting — Request queue and endpoints are not protected against abuse

Recommendations:

• Only run on trusted machines with trusted Claude instances
• Do not expose the HTTP server to network interfaces beyond localhost
• Do not run in multi-user environments without additional security hardening
• Review the code before use if you have security concerns

Architecture

Claude (MCP client)
  │ stdio (JSON-RPC)
  ▼
MCP Server (Node.js)
  │ In-memory state: pendingCode, pendingAction, browserState, requestQueue
  │
  ├─ HTTP Server (port 6002, auto-increment if busy)
  │   GET /              → HTML page with <strudel-editor> + request bar
  │   GET /api/poll      → Browser polls: returns pending code/action
  │   POST /api/state    → Browser posts: started, activeCode, error, cps
  │   POST /api/request  → User submits song/vibe request from browser UI
  │   GET /api/health    → Health check
  │
  └─ Browser (opened via `open` package)
      <strudel-editor> web component (loaded from unpkg CDN)
      Polls /api/poll every 1s, executes pending actions
      Posts state back via /api/state after each action
      Request bar at bottom for user input

Installation

1. Build the MCP server

npm install
npm run build

2. Configure in Claude Code / Claude Desktop

Add to your MCP settings (e.g., ~/.config/claude-code/mcp.json):

{
  "mcpServers": {
    "claude-dj": {
      "command": "node",
      "args": ["~/claude-dj-mcp/dist/index.js"]
    }
  }
}

Usage

Quick start

In Claude Code or Claude Desktop:

Use the claude-dj skill to start a DJ session

Or call tools directly:

Call start_session, then tell me when audio is ready

The DJ Loop

Once the session is started and audio is active:

1. Claude plays a pattern — Calls play_pattern with Strudel code
2. Claude announces — Calls dj_speak with DJ commentary
3. Claude waits — Calls wait(30-90) to let the music play
4. Claude checks requests — The wait tool returns any pending audience requests
5. Claude adapts — Creates the next pattern based on requests, mood, flow
6. Repeat

Audience requests

Users can type requests in the browser UI:

• "something funky"
• "chill lo-fi beats"
• "90s techno"
• "more cowbell"

Claude will acknowledge and incorporate requests into the next patterns.

MCP Tools (9 total)

... View full README on GitHub