MCP Mac Brightness Server
2025.03.15
1
PythonMac 设备控制屏幕亮度调节系统音量控制其它
MCP Mac Brightness Server 是一个基于 Model Context Protocol 的服务，主要用于控制 Mac 屏幕亮度和系统音量。它提供了屏幕亮度控制和系统音量控制的核心功能，适用于需要自动化调整屏幕亮度或音量的场景。
View on GitHub
Overview
基本能力
产品定位
MCP Mac Brightness Server 是一个专门用于控制 Mac 设备屏幕亮度和系统音量的服务。
核心功能
- 屏幕亮度控制
- 获取当前屏幕亮度
- 设置屏幕亮度（支持渐变效果）
- 支持亮度范围：0-100%
- 系统音量控制
- 获取当前系统音量
- 设置系统音量
- 切换系统静音状态
适用场景
- 自动化调整屏幕亮度以适应环境光线变化
- 批量调整多台 Mac 设备的显示设置
- 开发需要控制音量的应用程序
- 创建自定义的亮度/音量控制快捷键
工具列表
get_screen_brightness()- 获取当前屏幕亮度（0-100）set_screen_brightness(brightness: float, duration: float = 0)- 设置屏幕亮度get_system_volume()- 获取当前系统音量（0-100）set_system_volume(volume: int)- 设置系统音量toggle_system_mute()- 切换系统静音状态
常见问题解答
- 输入验证确保亮度和音量在有效范围内
- 详细的错误信息帮助诊断系统API故障
- 优雅处理权限问题
使用教程
使用依赖
- Python ≥ 3.10
- macOS 系统（使用原生 macOS 框架）
- 屏幕和音频控制权限
- 安装 brightness 工具：
bash brew install brightness
安装教程
uv pip install -e .
调试方式
在 Claude desktop 中配置：
{
"mac_brightness": {
"command": "uvx",
"args": ["mcp-server-mac-brightness"]
}
}