Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Vcv Rack

FreeNot checked

Enables LLMs to compose VCV Rack modular synth patches by generating plain JSON, with tools for patch creation, catalog search, and live OSC control.

GitHubEmbed

About

Enables LLMs to compose VCV Rack modular synth patches by generating plain JSON, with tools for patch creation, catalog search, and live OSC control.

README

MCP server for VCV Rack 2 built around one insight: .vcv patch files are plain JSON, so an LLM can compose modular synth patches by emitting structured data — no GUI automation, ever.

Status: v0.1.0 — Webapp and Core complete. Patch generation, catalog, validation, OSC bridge, webapp dashboard, Playwright E2E tests, and agentic workflow all working. Manual gates P2 (round-trip in Rack) and P3 (OSC e2e) still need a human with Rack open.

Quick Start

git clone https://github.com/sandraschi/vcv-rack-mcp
cd vcv-rack-mcp
uv sync
uv run -m vcv_rack_mcp

Tools

Tool What it does
vcv_patch Create, edit, validate, list, get, open_in_rack, rack_cycle, import patches, set_module_data
vcv_catalog Search catalog, get module details, verify installed, library link, sideload, suggest rack
vcv_live OSC address map, performance sheet for live tweaking
vcv_agentic_workflow ctx.sample loop: brief → generate → validate → retry (max 3)
show_patch_card / show_catalog_card Prefab UI cards
hub_status Catalog size, depot health, Rack path
vcv_shutdown Graceful self-termination (+ POST /api/shutdown)

Architecture

vcv-rack-mcp (port 10916, stdio / HTTP /mcp)
  ├── catalog/modules.yaml — 50 modules, 50/50 generative/performance
  ├── depot/ — .vcv patches + SQLite metadata + sidecar .md
  └──→ osc-mcp (port 10767) — vcv_manager consumes address maps

What's Real vs What Needs Human

Feature Status Gate
Catalog (50 modules, incl. Stoermelder TRANSIT) Done, validated P1
Patch generation Done, deterministic P2 (needs Rack round-trip)
Validation (4 checks, incl. module data) Done with tests P2
OSC address map Done P3 (needs osc-mcp e2e)
Agentic workflow Done P4
Webapp Done, with Playwright E2E tests P5
Tauri wrapper Future P5

Ports

  • Backend: 10916 (FastMCP + FastAPI)
  • Frontend: 10917 (Vite React, active)
  • OSC control: delegates to osc-mcp port 10767

from github.com/sandraschi/vcv-rack-mcp

Installing Vcv Rack

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/sandraschi/vcv-rack-mcp

FAQ

Is Vcv Rack MCP free?

Yes, Vcv Rack MCP is free — one-click install via Unyly at no cost.

Does Vcv Rack need an API key?

No, Vcv Rack runs without API keys or environment variables.

Is Vcv Rack hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Vcv Rack in Claude Desktop, Claude Code or Cursor?

Open Vcv Rack on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Vcv Rack with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All development MCPs