File size: 2,217 Bytes
2359fb1
7cf0961
 
 
64c9482
0cf3d62
0548359
64c9482
 
 
0cf3d62
 
 
64c9482
0548359
64c9482
 
 
0548359
64c9482
 
 
 
 
0548359
64c9482
0548359
 
 
64c9482
dcfc9c9
64c9482
 
 
 
 
 
dcfc9c9
 
 
 
 
 
64c9482
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
003a511
0cf3d62
dcfc9c9
0cf3d62
dcfc9c9
0cf3d62
 
dcfc9c9
 
715eca0
 
64c9482
dcfc9c9
64c9482
dcfc9c9
64c9482
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
# PluginBridge β€” Sync File

---

## STATUS: v0.5.2 β€” SPRINT 3 COMPLETE (2026-05-17)

Build: βœ… Clean  
GUI: βœ… Working (Pro-Q 4, God Particle, Little MicroShift, LIMITER)  
MCP: βœ… Verified end-to-end β€” registered in Claude Code config  
Crashes: βœ… None (unsafe plugins handled via audio-only mode)

---

## MCP INTEGRATION CONFIRMED

**Server:** `http://127.0.0.1:16620/mcp`  
**Registered as:** `pluginbridge` in Claude Code local config  
**Scope:** AI MUSIC PRODUCTION project

**Verified working (2026-05-17):**
- `GET /health` β†’ `{"status":"ok","helper":"connected","port":16620}`
- `initialize` β†’ handshake complete
- `tools/list` β†’ 5 tools registered
- `search_param "band 1"` β†’ 24 params returned from Pro-Q 4 with real values

**Pro-Q 4 via MCP:** 737 parameters fully accessible (vs 1 parameter via Ableton LOM)

---

## SPRINTS

| Sprint | Status | What |
|---|---|---|
| Sprint 1 | βœ… | Plugin shell + MCP server |
| Sprint 2 | βœ… | Out-of-process hosting, crash-safe, GUI |
| Sprint 3 | βœ… | MCP param control β€” verified from Claude Code |
| Sprint 4 | **NEXT** | Real-time audio analysis (LUFS, FFT, spectral) |

---

## ARCHITECTURE (v0.5.2)

```
Claude Code / Gemini CLI
    β”‚
    β”œβ”€β”€ ableton-live-mcp (port 16619) β€” DAW control, LOM, tracks, routing
    β”‚
    └── pluginbridge (port 16620) β€” plugin parameter control
            β”‚
            β–Ό
    PluginBridge.vst3 (inside Ableton)
    β”œβ”€β”€ In-process GUI (safe plugins)
    β”œβ”€β”€ Shared memory audio β†’ Helper process (crash-safe)
    β”œβ”€β”€ MCP server (5 tools)
    └── Safety DB + blocklist

    PluginBridgeHelper.app (separate process)
    β”œβ”€β”€ Audio processing via shared memory
    β”œβ”€β”€ --scan mode for safety testing
    └── --load mode for audio routing
```

---

## BUILD

```bash
cd "/Volumes/T7 Shield/Users/Aditya/pluginbridge/build"
cmake --build . --target PluginBridge_VST3 -- -j4
```

---

## MODE: NORMAL (build+test only)

Claude Code rules:
- `pull and build` β†’ pull + cmake build + report result
- `pull and test` β†’ pull + build + run curl tests + report
- For debugging: ML Intern will update SYNC.md to grant full debug mode when needed