概览
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.
