# DDC/CI Control Bridge

An MCP server that lets your agent drive DDC/CI on a monitor: brightness, contrast, power and input. MQTT support included.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: Defozo
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Defozo/ddc-ci-control-bridge
- Updated: 2026-02-02
- HTML: https://affpapa.org/en/nevibecode/mcp/ddcci-control-bridge

## What it does

The server reads and writes monitor VCP codes over DDC/CI, which covers brightness, contrast, input source and power state. Windows, Linux and macOS are all supported. You can install it globally with `npm install -g ddc-ci-control-bridge`, skip installation entirely with `npx ddc-ci-control-bridge`, or grab a standalone executable for your platform.

Two protocols sit inside. MCP exposes resources and tools to the agent; MQTT connects to any broker and supports Home Assistant auto-discovery. Turn MQTT on with `MQTT_ENABLED=true` and point `MQTT_HOST` at your broker. One catch with the standalone binary: it exits right away unless `DDC_API_KEY` is set, so set that variable first.

Pick local stdio when the client and the monitors share a machine. Pick remote HTTP when the server runs on the monitor-connected computer and you want to reach it from elsewhere. In Claude a single add command is enough to get going.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add ddc-ci-control-bridge -- npx -y ddc-ci-control-bridge
```

### Codex

**Platform CLI**
```bash
codex mcp add ddcci-control-bridge -- npx -y ddc-ci-control-bridge
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ddcci-control-bridge": {
            "command": "npx",
            "args": [
                "-y",
                "ddc-ci-control-bridge"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ddcci-control-bridge": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "ddc-ci-control-bridge"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add ddcci-control-bridge npx -y ddc-ci-control-bridge
```

## When to use it
- dim a monitor from the terminal
- switch the display to another input
- turn a screen off on a schedule
- read the current VCP codes
- expose monitor control to Home Assistant

## Example prompts
- Set the main monitor brightness to 40
- Switch the input to HDMI-2
- Power off the monitor over DDC/CI

## Similar
- [Doc Bridge](https://affpapa.org/en/nevibecode/mcp/doc-bridge.md) — MCP server · ★ 10
- [Maplith Bridge](https://affpapa.org/en/nevibecode/mcp/maplith-bridge.md) — MCP server · ★ 1
- [home-assistant-best-practices](https://affpapa.org/en/nevibecode/skills/home-assistant-best-practices.md) — skill · 8600 installs
- [mcp-hass](https://affpapa.org/en/nevibecode/skills/mcp-hass.md) — skill · 3100 installs
- [hass-builder](https://affpapa.org/en/nevibecode/skills/hass-builder.md) — skill · 1600 installs
- [ha-mcp](https://affpapa.org/en/nevibecode/mcp/ha-mcp.md) — MCP server · ★ 5280

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md