🎧 Epistemic DJ

MCP server that maps epistemic state to generative music via Strudel.cc

Transform your cognitive state into sound. High uncertainty? Dissonant, chaotic patterns. Deep focus? Clean, driving beats. Celebrating a win? Full-on euphoric build-ups.

Features

• MCP Tools for Claude Code integration

• Pattern Generator - 13 epistemic vectors → Strudel live coding patterns

• Mood Presets - focus, energize, reflect, debug, celebrate

• Web UI - Interactive sliders + embedded Strudel REPL

• Audio Analyzer (coming soon) - Extract epistemic vectors from music

Related MCP server: MCP Music Studio

Quick Start

# Install
npm install

# Test the pattern generator
node src/generator/epistemic-to-strudel.js --mood celebrate

# Run the MCP server
node src/mcp/server.js

# Serve the web UI
npx serve src/web

MCP Tools

generate_pattern

Generate a Strudel pattern from epistemic vectors.

{
  "vectors": {
    "know": 0.7,
    "uncertainty": 0.3,
    "engagement": 0.8,
    "clarity": 0.6,
    "coherence": 0.7,
    "signal": 0.5,
    "completion": 0.4
  },
  "mode": "full"
}

generate_mood

Generate a pattern for a mood preset.

{
  "mood": "focus"
}

explain_mapping

Understand how vectors map to music.

crossfade_pattern

Generate transition patterns between states.

Epistemic → Musical Mappings

Claude Code Integration

Add to your Claude Code MCP config:

{
  "mcpServers": {
    "epistemic-dj": {
      "command": "node",
      "args": ["/path/to/epistemic-dj/src/mcp/server.js"]
    }
  }
}

Then in Claude:

Generate a pattern for my current epistemic state:
- know: 0.6 (decent understanding)
- uncertainty: 0.4 (some unknowns)
- engagement: 0.8 (highly focused)

Roadmap

• Pattern generator (vectors → Strudel)

• MCP server with tools

• Web UI with sliders

• Audio analyzer (music → vectors)

• WebSocket bridge for real-time updates

• Empirica integration for automatic state tracking

• Feedback loop (music influences cognition?)

License

MIT

Credits

Built with:

• Strudel - Live coding music in the browser

• MCP SDK - Model Context Protocol

• Empirica - Epistemic self-assessment