DDC/CI Control Bridge

DDC/CI Control Bridge

Multi-protocol server for DDC/CI monitor control with MCP and MQTT support.

Features

• DDC/CI Monitor Control: Read and write VCP codes to control monitor brightness, contrast, input source, and more
• Model Context Protocol (MCP): Server with resources and tools for AI/agent integration
• MQTT Client: Connect to any MQTT broker for IoT/automation platforms
• Home Assistant auto-discovery support
• Generic MQTT pub/sub for custom integrations
• Cross-Platform: Works on Windows, Linux, and macOS
• Dual Distribution: Available as standalone executable or npm package

Quick Start

Installation

Option 1: NPM Package (Global)

npm install -g ddc-ci-control-bridge

ddc-ci-bridge

Option 2: NPX (No Install)

npx ddc-ci-control-bridge

Option 3: Standalone Executable

Download the binary for your platform from GitHub Releases:

• Windows: ddc-ci-bridge-win.exe
• Linux: ddc-ci-bridge-linux
• macOS: ddc-ci-bridge-macos

⚠️ Note: The executable requires DDC_API_KEY environment variable to be set, or it will exit immediately.

Windows:

# Set API key (required)

set DDC_API_KEY=your-secret-key

Run the executable

ddc-ci-bridge-win.exe

Or set multiple environment variables

set DDC_API_KEY=your-secret-key set MQTT_ENABLED=true set MQTT_HOST=192.168.1.100 ddc-ci-bridge-win.exe

Linux/macOS:

# Make executable (first time only)

chmod +x ddc-ci-bridge-linux # or ddc-ci-bridge-macos

Run with API key (required)

DDC_API_KEY=your-secret-key ./ddc-ci-bridge-linux

Or with multiple environment variables

DDC_API_KEY=your-secret-key MQTT_ENABLED=true MQTT_HOST=192.168.1.100 ./ddc-ci-bridge-linux

Using with MCP Clients:

Configure your MCP client to use the executable path:

{

"mcpServers": { "ddc-ci-bridge": { "command": "C:\\path\\to\\ddc-ci-bridge-win.exe", "args": [], "env": { "MQTT_ENABLED": "false" } } } }

MCP Client Setup

Choose between Local (stdio) or Remote (HTTP) setup depending on your needs:

• Local Setup: Run MCP server on the same machine as your monitors (recommended for most users)
• Remote Setup: Run MCP server on a monitor-connected machine, access from other devices

---

🖥️ Local Setup (stdio - Same Machine)

Use this if your MCP client is on the same machine as your monitors.

Install in Cursor (Local)

Go to: Settings → Cursor Settings → MCP → Add new global MCP server

Or paste the following configuration into your ~/.cursor/mcp.json file:

{

"mcpServers": { "ddc-ci-bridge": { "command": "npx", "args": ["-y", "ddc-ci-control-bridge"], "env": { "MQTT_ENABLED": "false", "MQTT_HOST": "localhost", "MQTT_PORT": "1883" } } } }

Optional MQTT: Set MQTT_ENABLED=true and configure MQTT_HOST to your MQTT broker IP for automation platform integration.

Install in VS Code (Local)

Add this to your VS Code MCP config file:

"mcp": {

"servers": { "ddc-ci-bridge": { "type": "stdio", "command": "npx", "args": ["-y", "ddc-ci-control-bridge"], "env": { "MQTT_ENABLED": "false" } } } }

Install in Claude Desktop (Local)

Open Claude Desktop developer settings and edit your claude_desktop_config.json file:

{

"mcpServers": { "ddc-ci-bridge": { "command": "npx", "args": ["-y", "ddc-ci-control-bridge"], "env": { "MQTT_ENABLED": "false" } } } }

Install in Claude Code (Local)

Run this command:

claude mcp add ddc-ci-bridge -- npx -y ddc-ci-control-bridge

Install in Windsurf (Local)

Add this to your Windsurf MCP config file:

{

"mcpServers": { "ddc-ci-bridge": { "command": "npx", "args": ["-y", "ddc-ci-control-bridge"], "env": { "MQTT_ENABLED": "false" } } } }

Install in Cline (Local)

Add this to your Cline MCP configuration:

{

"mcpServers": { "ddc-ci-bridge": { "command": "npx", "args": ["-y", "ddc-ci-control-bridge"], "env": { "MQTT_ENABLED": "false" } } } }

Install in Zed (Local)

Add this to your Zed settings.json:

{

"context_servers": { "DDC/CI Bridge": { "source": "custom", "command": "npx", "args": ["-y", "ddc-ci-control-bridge"], "env": { "MQTT_ENABLED": "false" } } } }

Install in Roo Code (Local)

Add this to your Roo Code MCP configuration:

{

"mcpServers": { "ddc-ci-bridge": { "command": "npx", "args": ["-y", "ddc-ci-control-bridge"], "env": { "MQTT_ENABLED": "false" } } } }

Install in Augment Code (Local)

Option A: Using the UI

1. Click the hamburger menu
2. Select Settings
3. Navigate to Tools section
4. Click + Add MCP button
5. Enter command: npx -y ddc-ci-control-bridge
6. Name: DDC/CI Bridge
7. Click Add

Option B: Manual Configuration

Add to settings.json:

"augment.advanced": {

"mcpServers": [ { "name": "ddc-ci-bridge", "command": "npx", "args": ["-y", "ddc-ci-control-bridge"], "env": { "MQTT_ENABLED": "false" } } ] }

Install in JetBrains AI Assistant (Local)

1. Go to Settings → Tools → AI Assistant → Model Context Protocol (MCP)
2. Click + Add
3. Select As JSON from the dropdown
4. Add this configuration:

{

"mcpServers": { "ddc-ci-bridge": { "command": "npx", "args": ["-y", "ddc-ci-control-bridge"], "env": { "MQTT_ENABLED": "false" } } } }

1. Click Apply to save changes

Install in Warp (Local)

1. Navigate Settings → AI → Manage MCP servers
2. Click + Add button
3. Paste this configuration:

{

"DDC/CI Bridge": { "command": "npx", "args": ["-y", "ddc-ci-control-bridge"], "env": { "FASTMCP_API_KEY": "your-api-key-here", "MQTT_ENABLED": "false" }, "working_directory": null, "start_on_launch": true } }

1. Click Save

Install in OpenAI Codex (Local)

Add to your Codex MCP configuration:

[mcp_servers.ddc-ci-bridge]

command = "npx" args = ["-y", "ddc-ci-control-bridge"]

[mcp_servers.ddc-ci-bridge.env] MQTT_ENABLED = "false"

Windows Users: Use full paths if you encounter timeout errors:

[mcp_servers.ddc-ci-bridge]

command = "cmd" args = ["/c", "npx", "-y", "ddc-ci-control-bridge"] startup_timeout_ms = 20_000

[mcp_servers.ddc-ci-bridge.env] SystemRoot = "C:\\Windows" FASTMCP_API_KEY = "your-api-key-here" MQTT_ENABLED = "false"

Install in LM Studio (Local)

1. Navigate to Program (right side) → Install → Edit mcp.json
2. Add this configuration:

{

"mcpServers": { "DDC/CI Bridge": { "command": "npx", "args": ["-y", "ddc-ci-control-bridge"], "env": { "MQTT_ENABLED": "false" } } } }

1. Click Save
2. Toggle the MCP server on/off from the right side panel

Install in Qodo Gen (Local)

1. Open Qodo Gen chat panel in VSCode or IntelliJ
2. Click Connect more tools
3. Click + Add new MCP
4. Add this configuration:

{

"mcpServers": { "ddc-ci-bridge": { "command": "npx", "args": ["-y", "ddc-ci-control-bridge"], "env": { "MQTT_ENABLED": "false" } } } }

Install in Perplexity Desktop (Local)

1. Navigate Perplexity → Settings
2. Select Connectors
3. Click Add Connector
4. Select Advanced
5. Enter Server Name: DDC/CI Bridge
6. Paste this JSON:

{

"command": "npx", "args": ["-y", "ddc-ci-control-bridge"], "env": { "FASTMCP_API_KEY": "your-api-key-here", "MQTT_ENABLED": "false" } }

1. Click Save

Install in Kiro (Local)

1. Navigate Kiro → MCP Servers
2. Click + Add button
3. Paste this configuration:

{

"mcpServers": { "DDC/CI Bridge": { "command": "npx", "args": ["-y", "ddc-ci-control-bridge"], "env": { "MQTT_ENABLED": "false" }, "disabled": false, "autoApprove": [] } } }

1. Click Save

Install in BoltAI (Local)

1. Open Settings → Plugins
2. Enter this JSON:

{

"mcpServers": { "ddc-ci-bridge": { "command": "npx", "args": ["-y", "ddc-ci-control-bridge"], "env": { "MQTT_ENABLED": "false" } } } }

1. Save and restart if needed

Install in Zencoder (Local)

1. Go to Zencoder menu (...)
2. Select Agent tools
3. Click Add custom MCP
4. Add name and server configuration:

{

"command": "npx", "args": ["-y", "ddc-ci-control-bridge"], "env": { "FASTMCP_API_KEY": "your-api-key-here", "MQTT_ENABLED": "false" } }

1. Click Install

Install in Amazon Q Developer CLI (Local)

Add to your Amazon Q configuration:

{

"mcpServers": { "ddc-ci-bridge": { "command": "npx", "args": ["-y", "ddc-ci-control-bridge"], "env": { "MQTT_ENABLED": "false" } } } }

Using Bun or Deno

Bun:

{

"mcpServers": { "ddc-ci-bridge": { "command": "bunx", "args": ["-y", "ddc-ci-control-bridge"], "env": { "MQTT_ENABLED": "false" } } } }