Mcp Server Mac Brightness
What is Mcp Server Mac Brightness
mcp_server_mac_brightness is a Model Context Protocol server designed to control the screen brightness and system volume of Mac computers.
Use cases
Use cases include adjusting screen brightness based on ambient light, setting volume levels for presentations, and automating audio settings in various applications.
How to use
To use mcp_server_mac_brightness, install the required dependencies, start the server, and utilize the provided functions to get or set screen brightness and system volume.
Key features
Key features include screen brightness control (get and set brightness with fade duration), system volume control (get and set volume, toggle mute), and support for a brightness range of 0-100%.
Where to use
mcp_server_mac_brightness can be used in software applications that require control over Mac display settings and audio management, such as media players or automation scripts.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Mcp Server Mac Brightness
mcp_server_mac_brightness is a Model Context Protocol server designed to control the screen brightness and system volume of Mac computers.
Use cases
Use cases include adjusting screen brightness based on ambient light, setting volume levels for presentations, and automating audio settings in various applications.
How to use
To use mcp_server_mac_brightness, install the required dependencies, start the server, and utilize the provided functions to get or set screen brightness and system volume.
Key features
Key features include screen brightness control (get and set brightness with fade duration), system volume control (get and set volume, toggle mute), and support for a brightness range of 0-100%.
Where to use
mcp_server_mac_brightness can be used in software applications that require control over Mac display settings and audio management, such as media players or automation scripts.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
MCP Mac Brightness Server
A Model Context Protocol server for controlling Mac screen brightness and system volume.
Features
-
Screen Brightness Control
- Get current screen brightness
- Set screen brightness with optional fade duration
- Supports brightness range: 0-100%
-
System Volume Control
- Get current system volume
- Set system volume
- Toggle system mute state
Requirements
- Python >= 3.10
- macOS (uses native macOS frameworks)
- Required permissions for screen and audio control
- brightness (Install via Homebrew):
brew install brightness
Installation
uv pip install -e .
Usage
Start the Server
Available Tools
-
get_screen_brightness()
- Returns current screen brightness (0-100)
-
set_screen_brightness(brightness: float, duration: float = 0)
- Set screen brightness level
- brightness : Target brightness (0-100)
- duration : Fade duration in seconds (0 for immediate change)
-
get_system_volume()
- Returns current system volume (0-100)
-
set_system_volume(volume: int)
- Set system volume level (0-100)
-
toggle_system_mute()
- Toggle system audio mute state
Configuration
Configure in Claude desktop:
{
"mac_brightness": {
"command": "uvx",
"args": [
"mcp-server-mac-brightness"
]
}
}Error Handling
- Input validation for brightness and volume levels
- Comprehensive error messages for system API failures
- Graceful error handling for permission issues
License
MIT License
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
