Skip to main content
Glama

Q-SYS MCP Server

by charliem716
GitHub
JavaScript
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Q-SYS MCP3.0 Server

Ultra-minimal MCP server for Q-SYS control. 582 lines, 3 dependencies, 4 tools.

Quick Start

# Install (only 3 dependencies) npm install # Run with Q-SYS Core IP QSYS_HOST=192.168.1.100 node index.js # With debug logging QSYS_HOST=192.168.1.100 QSYS_MCP_DEBUG=true node index.js

Configuration

Environment Variables (Required)

QSYS_HOST=192.168.1.100 # Q-SYS Core IP address (required) QSYS_PORT=443 # WebSocket port (default: 443) QSYS_SECURE=true # Use secure WebSocket (default: true) QSYS_POLLING_INTERVAL=350 # Control polling interval in ms (default: 350) QSYS_MCP_DEBUG=true # Enable debug logging (default: false)

Persistent Configuration

The server saves successful connections to ~/.qsys-mcp/last-connection.json for convenience.

Tools

All tools auto-connect using the QSYS_HOST environment variable if not already connected.

qsys_status

Get connection and system status without triggering auto-connection.

{ "detailed": false // Include component inventory }

qsys_discover

List components and controls. Auto-connects if needed.

{ "component": "Gain.*", // Optional regex filter "includeControls": true // Include control details }

qsys_get

Read control values with metadata. Auto-connects if needed.

{ "controls": ["Gain_1.gain", "Gain_1.mute"] } // Returns: value, string, position, bool, direction, choices, min, max

qsys_set

Update control values with validation. Auto-connects if needed.

{ "controls": [ { "path": "Gain_1.gain", "value": -10, "force": false // Required for protected controls } ] }

Protected Controls

These patterns require force: true to modify:

  • Master.* - Master controls

  • Emergency.* - Emergency systems

  • *.power - Power controls

  • SystemMute - System-wide mutes

Core Features

  • Auto-connection: Connects automatically using QSYS_HOST environment variable

  • Auto-reconnection: Exponential backoff (1s, 2s, 4s, 8s, 16s)

  • Discovery cache: 1-second cache for performance

  • Parallel operations: Batch updates execute simultaneously

  • Type validation: Enforces Boolean, Float, Integer types

  • Range validation: Respects min/max limits

  • Helpful errors: Suggests available components/controls

Performance

  • Connection time: < 1 second

  • Memory usage: < 50MB typical

  • Startup time: < 500ms

  • Batch limits: 100 get, 50 set

Claude Desktop Configuration

Add to your Claude Desktop config:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "qsys-mcp3": { "command": "node", "args": ["/absolute/path/to/MCP3.0/index.js"], "env": { "QSYS_HOST": "192.168.50.150", "QSYS_PORT": "443", "QSYS_MCP_DEBUG": "false" } } } }

Replace /absolute/path/to/MCP3.0/index.js with your actual path. Replace 192.168.50.150 with your Q-SYS Core IP address.

Testing

Basic functionality test:

# Set your Q-SYS Core IP export QSYS_HOST=192.168.50.150 # Run the server node index.js # In another terminal, use the MCP inspector or test scripts

For comprehensive testing, see test-prompts-v2.md.

License

MIT

Deploy Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

Enables control and monitoring of Q-SYS audio/video systems through WebSocket connection. Provides tools for discovering components, reading/setting control values, and managing system status with built-in protection for critical controls.

  1. Quick Start
    1. Configuration
      1. Environment Variables (Required)
      2. Persistent Configuration
    2. Tools
      1. qsys_status
      2. qsys_discover
      3. qsys_get
      4. qsys_set
    3. Protected Controls
      1. Core Features
        1. Performance
          1. Claude Desktop Configuration
            1. Testing
              1. License

                Related MCP Servers

                • MCP Proxy Sidecar

                  dortegau
                  -
                  security
                  A
                  license
                  -
                  quality
                  A modified JetBrains MCP Server that adds WebSocket monitoring capabilities, allowing users to monitor MCP tool calls in real-time while maintaining compatibility with the original implementation.
                  Last updated -
                  0
                  1
                  Apache 2.0
                  • Apple

                • OBS MCP Server

                  royshil
                  -
                  security
                  A
                  license
                  -
                  quality
                  A server that provides tools to control OBS Studio remotely via the OBS WebSocket protocol, enabling management of scenes, sources, streaming, and recording through an MCP client interface.
                  Last updated -
                  10
                  44
                  GPL 2.0

                • Sonos MCP Server

                  WinstonFassett
                  A
                  security
                  F
                  license
                  A
                  quality
                  A server that allows you to control and interact with Sonos devices on your network through the Model Context Protocol, providing functionalities for discovering devices, controlling playback, retrieving device states, and managing queues.
                  Last updated -
                  18
                  3

                • After Effects Motion Control Panel

                  PankajBagariya
                  -
                  security
                  A
                  license
                  -
                  quality
                  A robust system that connects web UI to After Effects, enabling real-time command processing and monitoring with comprehensive error handling.
                  Last updated -
                  1
                  MIT License

                View all related MCP servers

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/charliem716/MCP3.0'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server