strudel-ai

Local HTTP + MCP tool for AI agents to write/edit Strudel code, offline-render WAV audio, and get a structured “hearing” report (waveform, spectrogram, dB envelopes, bands, onsets, estimated BPM).

Sibling project to cryptid-crawler — finished sounds can be copied into the game later.

License: AGPL-3.0-or-later (inherits from Strudel / superdough).

Quick start

cd ~/Projects/strudel-ai
npm install
npm run smoke          # render + analyze a tiny pattern
npm start              # HTTP on http://127.0.0.1:8787
npm run mcp            # MCP stdio server for Cursor

Related MCP server: MCP MiniMax Music Server

Agent loop

1. POST /sessions → create session

2. PUT /sessions/:id/code → write Strudel

3. POST /sessions/:id/render-analyze → WAV + hearing report

4. Read hearing.summary / artifacts; PATCH /sessions/:id/code to edit

5. GET /sessions/:id/diff?from=1&to=2 → code + metric deltas

Same ops exist as MCP tools: session_create, code_set, code_patch, render_analyze, hearing_get, session_diff, artifact_paths, …

HTTP surface

Example

SID=$(curl -s -X POST http://127.0.0.1:8787/sessions -H 'content-type: application/json' -d '{"title":"demo"}' | jq -r .id)

curl -s -X PUT http://127.0.0.1:8787/sessions/$SID/code \
  -H 'content-type: application/json' \
  -d '{"code":"note(\"c3 e3 g3 c4\").s(\"sawtooth\").gain(0.4)"}' | jq .currentRevision

curl -s -X POST http://127.0.0.1:8787/sessions/$SID/render-analyze \
  -H 'content-type: application/json' \
  -d '{"cycles":2,"cps":0.5}' | jq '.hearing.summary'

Cursor MCP config

Add to your MCP settings (stdio):

{
  "mcpServers": {
    "strudel-ai": {
      "command": "npx",
      "args": ["tsx", "src/cli.ts", "mcp"],
      "cwd": "/home/agbowman99/Projects/strudel-ai"
    }
  }
}

Notes

• Default sample bank is github:tidalcycles/dirt-samples (override with STRUDEL_AI_SAMPLES). Synths (sawtooth, sine, …) come from superdough.

• @kabelsalat/web is patched on postinstall so Node can import SalatRepl.

• Session data lives in ./sessions/ (gitignored).

• Architecture diagram: mermaid-lite project Strudel AI (ml show "Strudel AI").