Vcv Rack
FreeNot checkedEnables LLMs to compose VCV Rack modular synth patches by generating plain JSON, with tools for patch creation, catalog search, and live OSC control.
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
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-mcpFAQ
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
GitHub
PRs, issues, code search, CI status
by GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
by mcpdotdirectServer Sequential Thinking
MCP server for sequential thinking and problem solving
by GitHub ActionsUnyly Deploy
Deploy sites and MCP servers to Unyly straight from your AI agent
by UnylyAmap Maps Mcp Server
MCP server for using the AMap Maps API
by duxiaohuiPayMCP
Lightweight payments layer for MCP servers: turn tools into paid endpoints with a two-line decorator. [PyPI](https://pypi.org/project/paymcp/) · [npm](https://w
by blustAIServer For Power BI
Enables exploring Microsoft Fabric / Power BI workspaces and semantic models, and executing ad-hoc DAX queries.
by Mitsubishi-FusoGpt Image 2 Mcp
RunAPI GPT Image 2 MCP server for image generation: create tasks, poll results, and check pricing across 1 model from Claude Code, Codex, Cursor, and VS Code.
by runapi-aiCompare 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
