strudel-mcp

MCP (Model Context Protocol) bridge for Strudel live coding environment.

Let AI assistants generate and inject musical patterns into Strudel in real-time!

Installation

npm install -g strudel-mcp

Quick Start

1. Integrate with your Strudel project

cd your-strudel-project
npx strudel-mcp integrate

2. Start the MCP server

strudel-mcp

3. Start Strudel

pnpm dev

Look for the green "MCP" badge in the Strudel header - you're connected!

Usage

Once running, the MCP server accepts patterns on port 3457:

# Test pattern injection
curl -X POST http://localhost:3457/inject \
  -H "Content-Type: application/json" \
  -d '{"pattern":"s(\"bd*4\").gain(0.8)"}'

For AI Assistants (Claude)

Add to your Claude MCP configuration:

{
  "mcpServers": {
    "strudel": {
      "command": "strudel-mcp"
    }
  }
}

Commands

• npx strudel-mcp integrate - Add MCP bridge to Strudel
• npx strudel-mcp remove - Remove MCP bridge
• npx strudel-mcp test - Test the integration
• strudel-mcp - Start the MCP server

Features

• 🔌 Zero-modification integration - No changes to Strudel core
• 🔒 Secure - Localhost only
• 🎵 Real-time - Patterns play instantly
• ✨ Visual feedback - MCP indicator in UI
• 🗑️ Easy removal - One command to uninstall

How It Works

1. AI generates a Strudel pattern
2. MCP server receives it on port 3457
3. Strudel polls the server every 500ms
4. Pattern is injected and auto-evaluated
5. Music plays instantly!

Troubleshooting

Port already in use

lsof -i :3457
kill <PID>

Integration not working

npx strudel-mcp test

Repository

https://codeberg.org/GlassOnTin/strudel-mcp

License

AGPL-3.0-or-later (same as Strudel)