# Install Bun (3x faster than Node.js)
curl -fsSL https://bun.sh/install | bash

# Ableton Live 11+ with AbletonOSC Remote Script
# Download: https://github.com/Fd2014/AbletonOSC

git clone https://github.com/TropinAlexey/ableton-and-max-mcp.git
cd ableton-and-max-mcp
bun install
bun start

{
  "mcpServers": {
    "ableton": {
      "command": "bun",
      "args": ["run", "/path/to/ableton-and-max-mcp/src/index.js"]
    }
  }
}

┌─────────────────────────────────────────────────────────┐
│                     Claude AI                            │
│         (MCP Client / Conversation Interface)            │
└─────────────────────────────────────────────────────────┘
                           ↓
                    MCP Protocol (JSON-RPC 2.0)
                           ↓
┌─────────────────────────────────────────────────────────┐
│          Ableton MCP Server (Bun Runtime)                │
│  - Tool Registration  (42 MCP tools)                     │
│  - Request Routing    (O(1) Map lookup)                  │
│  - OSC Client Layer   (Low-latency UDP)                  │
└─────────────────────────────────────────────────────────┘
                           ↓
                  OSC Protocol (UDP)
                   Port 11000-11001
                           ↓
┌─────────────────────────────────────────────────────────┐
│         Ableton Live + Max for Live                      │
│  - AbletonOSC Remote Script (MIDI Control Surface)       │
│  - Live Object Model (LOM) Access                        │
│  - Max for Live Integration                              │
└─────────────────────────────────────────────────────────┘

notes_generate_pattern(
  trackIndex: 0,
  pattern: "arpeggio_up",
  root: 60,           // C4
  scale: "major",
  length: 2           // 2 bars
)

Claude: "Create a new MIDI track called 'Bass'"
→ Uses: tracks_create_midi

User: "Generate a C major arpeggio over 4 bars"
→ Uses: notes_generate_pattern (arpeggio_up, C, major, 4 bars)

User: "Set the tempo to 140 BPM and play"
→ Uses: transport_set_tempo, transport_play

User: "Create a chord progression with Em, Am, C, G"
→ Uses: clips_create, notes_generate_pattern (chord) × 4

# Test without Ableton (Mock OSC Server)
npm run test:all

# Detailed OSC logging
DEBUG=1 bun start

# Watch mode (auto-reload)
bun run --watch src/index.js

src/
├── index.js           # MCP server entry point (99 lines)
├── osc-client.js      # OSC protocol layer (247 lines)
├── types.js           # JSDoc type definitions
└── tools/             # MCP tool implementations
    ├── transport.js   # Transport control
    ├── tracks.js      # Track management
    ├── clips.js       # Clip operations
    ├── notes.js       # MIDI editing + pattern generation
    ├── devices.js     # Device/FX control
    └── max.js         # Max for Live integration

Total: 1,245 lines of production JavaScript

// Before: O(n) string prefix checks
if (toolName.startsWith('transport_')) { ... }

// After: O(1) Map lookup
const executor = toolExecutors.get(toolName);

# Check ports are available
lsof -i :11000
lsof -i :11001

# Run with debug logging
DEBUG=1 bun start

# Verify AbletonOSC is installed:
~/Music/Ableton\ Library/Remote\ Scripts/AbletonOSC/

# Run all tests with Mock OSC Server
npm run test:all

# Test output shows:
# ✅ Transport tests (play, stop, tempo, jump)
# ✅ Tracks tests (volume, pan, mute, solo, arm)
# ✅ Clips tests (create, fire, delete)
# ✅ Notes tests (patterns, scales)
# ✅ Devices tests (parameters, enable/disable)
# ✅ Max tests (messaging, parameters)

# Production build (already JS, no compilation needed)
bun run src/index.js

# Or use npm (cross-platform)
npm start