Monitor Control Mcp

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.