# 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