Skip to main content
Glama

Q-SYS MCP Server

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

Q-SYS MCP3.0 Server

Ultra-minimal MCP server for Q-SYS control. ~400 lines, 3 dependencies, 5 tools.

Quick Start

# Install npm install # Run with environment variable QSYS_HOST=192.168.1.100 npm start # Run with debug logging npm run dev

Configuration

Environment Variables

QSYS_HOST=192.168.1.100 # Q-SYS Core IP address QSYS_PORT=443 # WebSocket port (default: 443) QSYS_AUTO_CONNECT=true # Auto-connect on startup QSYS_MCP_DEBUG=true # Enable debug logging QSYS_POLLING_INTERVAL=350 # Control polling interval in ms

Config File

The server saves successful connections to ~/.qsys-mcp/last-connection.json and auto-connects on next startup.

Tools

qsys_connect

Connect to Q-SYS Core with auto-reconnection.

{ "host": "192.168.1.100", "port": 443, "secure": true, "pollingInterval": 350 }

qsys_discover

List components and their controls.

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

qsys_get

Read control values.

{ "controls": ["Gain_1.gain", "Gain_1.mute"] }

qsys_set

Update control values with protection.

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

qsys_status

Get connection and system status.

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

Protected Controls

These patterns require force: true to modify:

  • Master.* - System-wide master controls
  • Emergency.* - Emergency systems
  • *.power - Power controls
  • SystemMute - Venue-wide mute

Features

  • Auto-reconnection: Exponential backoff (1s, 2s, 4s, 8s, 16s)
  • Global cache: 1-second discovery cache, clears on reconnect
  • Parallel operations: Batch updates execute simultaneously
  • Type validation: Enforces correct types for Boolean, Float, Integer
  • Range validation: Respects ValueMin/ValueMax limits
  • Helpful errors: Suggests available components/controls when not found

Performance

  • Tool response: <10ms overhead
  • Memory usage: <50MB
  • Startup time: <500ms
  • Connection time: <1 second
  • Batch operations: Parallel execution

MCP Client Configuration

Add to your MCP client config:

{ "mcpServers": { "qsys": { "command": "node", "args": ["/path/to/qsys-mcp3/index.js"], "env": { "QSYS_HOST": "192.168.1.100" } } } }

Testing

Manual testing checklist:

  1. Connect to Q-SYS Core
  2. Verify auto-reconnection (disconnect/reconnect network)
  3. Discover components
  4. Get/set control values
  5. Test protected controls
  6. Verify batch operations
  7. Monitor memory usage

Agent Prompts

See agent-mcp3-prompts.md for example system prompts for:

  • AV Room Controller Assistant
  • Audio System Troubleshooting Agent
  • Event Production Coordinator

License

MIT

Install 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
      2. Config File
    2. Tools
      1. qsys_connect
      2. qsys_discover
      3. qsys_get
      4. qsys_set
      5. qsys_status
    3. Protected Controls
      1. Features
        1. Performance
          1. MCP Client Configuration
            1. Testing
              1. Agent Prompts
                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 -
                    1
                    1
                    JavaScript
                    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 -
                    13
                    41
                    TypeScript
                    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
                    Python

                  • 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
                    Python
                    MIT License

                  View all related 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