qsys-mcp

MCP server for controlling Q-SYS systems over QSC's QRC protocol (JSON-RPC 2.0 over TCP on port 1710).

It exposes connect/status, discovery, read/write, snapshots, mixer and loop-player control, and change-group tools. It supports Designer Emulate mode, automatic reconnect after socket drops, and a 30 s NoOp keepalive.

Quick start:

npx -y q-sys-mcp

Claude Desktop example:

{
  "mcpServers": {
    "q-sys": {
      "command": "npx",
      "args": ["-y", "q-sys-mcp"]
    }
  }
}

From source:

git clone https://github.com/reowens/qsys-mcp.git
cd qsys-mcp
npm install
node dist/index.js

Requirements: Node.js >= 18 and a Q-SYS Core in Run mode or Q-SYS Designer in Emulate mode on 127.0.0.1:1710.