Monitor Control Mcp

Name: Monitor Control Mcp
Author: mingdedi

@mingdedi

Repository

About Monitor Control Mcp

Enable llm to control screen brightness or ...

#agents #windows #monitor #brightness

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "monitor-control": {
      "command": "uv",
      "args": [
        "run",
        "monitor-control-mcp"
      ],
      "cwd": "C:\\path\\to\\monitor-control-mcp"
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Monitor Control Mcp?

Monitor Control Mcp is a screen brightness control tool built on the Model Context Protocol (MCP). It allows AI assistants to intelligently adjust monitor brightness, contrast, and query RGB gain values over DDC/CI. It is designed for Windows 10/11 users with monitors that support DDC/CI and requires Python 3.10+.

How to use Monitor Control Mcp?

Clone the repository, install dependencies with uv sync or pip install -e ., then configure an MCP client (e.g., Claude Desktop, Cursor IDE) with the command uv and args ["run", "monitor-control-mcp"] pointing the working directory to the project path. The server exposes tools such as get_monitor_info, set_brightness, adjust_brightness, set_contrast, get_contrast, get_gain, and get_all_gains. Admin rights may be required.

Key features of Monitor Control Mcp

Detect all DDC/CI‑compatible monitors
Set brightness to any percentage (0–100%)
Adjust brightness relatively from current value
Control specific monitors or all monitors simultaneously
Automatic resource management to prevent handle leaks
Set and query contrast (0–100%)
Query red/green/blue gain (write disabled for compatibility)

Use cases of Monitor Control Mcp

Ask the AI to report current brightness of all monitors
Request a dimmer screen for night use (relative adjustment)
Set brightness to an exact percentage across all or a specific monitor
Increase contrast only on the primary monitor
Check the current RGB gain balance of a display

FAQ from Monitor Control Mcp

Why is no DDC/CI‑capable monitor detected?

The monitor may not support DDC/CI, the feature may be disabled in the OSD menu, or an unsupported cable/adapter is being used. Enable DDC/CI in the monitor’s OSD and use a quality DisplayPort/HDMI cable.

Why does setting or getting brightness fail?

This can be caused by insufficient permissions (run the terminal/IDE as administrator), a temporarily unresponsive monitor, or another program controlling the display. Restart the monitor and retry.

Can I control my laptop’s built‑in display?

Many laptop internal screens do not support DDC/CI. This tool is primarily for external monitors. Use Windows’ built‑in brightness control instead.

Why can’t I set RGB gain via `set_gain`?

The set_gain tool has been disabled due to poor hardware compatibility. Many monitors reject DDC/CI writes for gain, treat them as read‑only, or lock writes in preset modes (e.g., Standard, Game).

How do I fix “MCP server failed to start”?

Confirm Python ≥3.10, run uv sync to install dependencies, and verify the cwd path in the MCP client configuration points to the correct project directory. Check error logs for details.