Monitor Control Mcp
@mingdedi
About Monitor Control Mcp
Enable llm to control screen brightness or ...
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.
Frequently asked questions
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.
Basic information
More Other MCP servers
Website
FunnyWolfAdversary simulation and Red teaming platform with AI
🪟 Windows-MCP
CursorTouchMCP Server for Computer Use in Windows
Mobile Mcp
mobile-nextModel Context Protocol Server for Mobile Automation and Scraping (iOS, Android, Emulators, Simulators and Real Devices)
Peekaboo MCP – lightning-fast macOS screenshots for AI agents
steipetePeekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.
Mcp
browsermcpBrowser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser
Comments