RWAV Bridge MCP

Simple, local MCP server that exposes the RWAV Bridge (Roon Extension) as safe, typed tools for AI assistants and MCP clients (VS Code, Roo Code, Copilot, etc.).

• Local-first: stdio MCP process; discovers RWAV Bridge automatically.
• Works on macOS, Windows, Linux.
• One-time setup for GUI clients so it “just works”.

What is it? RWAV Bridge MCP is a small, local server that exposes the RWAV Bridge (Roon extension) as a set of safe, typed tools_* APIs. It gives editors and AI assistants a reliable, guard‑railed way to control playback, browse your library and services, and report status — all without scripting Roon directly.

How it works. Your client (VS Code, Roo Code, Copilot, etc.) connects over stdio, discovers your running RWAV Bridge, and calls a curated allowlist of actions (play/pause/next/queue/search/album/playlist/radio, and more). Every action is designed to be verifiable and safe — with volume and skip etiquette baked in.

Who it’s for. Anyone who wants quick, trustworthy music control while staying in flow — builders, writers, and tinkerers. It’s great for voice/agent workflows and for power users who prefer concise, tool‑driven control.

Next steps. Start with the Quick Start to get connected fast. Then explore the Tutorials for environment setup tips, client configuration, and examples.

Install (quick)

Windows / Linux (npm)

npm i -g @calibress/rwav-bridge-mcp

Windows (Scoop)

scoop bucket add calibress https://github.com/calibress/scoop-bucket
scoop install rwav-bridge-mcp

macOS (Homebrew)

1. brew install calibress/rwav/rwav-bridge-mcp
2. rwav-bridge-mcp --help → should print “RWAV Bridge MCP v…”

Note: Recent Homebrew installer runs setup automatically. Only run rwav-bridge-mcp-setup if a GUI client can’t find the binary.

Uninstall

• Homebrew (macOS): brew uninstall calibress/rwav/rwav-bridge-mcp
• npm (Windows/Linux/macOS): npm uninstall -g @calibress/rwav-bridge-mcp

Troubleshooting

• Help/version: rwav-bridge-mcp --help or --version
• Not found in a GUI client: run rwav-bridge-mcp-setup to re‑pin the absolute path.
• Roon not connected: ensure RWAV Bridge is enabled in Roon → Settings → Extensions.