Mac屏幕亮度控制服务

MCP Mac亮度服务器

用于控制Mac屏幕亮度和系统音量的模型上下文协议服务器。

特性

• 屏幕亮度控制

  • 获取当前屏幕亮度
  • 使用可选的淡入淡出持续时间设置屏幕亮度
  • 支持亮度范围：0-100%

• 系统音量控制

  • 获取当前系统卷
  • 设置系统音量
  • 切换系统静音状态

需求

• Python>=3.10
• macOS（使用原生macOS框架）
• 屏幕和音频控制所需的权限
• 亮度（通过Homebrew安装）：
  复制

  brew install brightness
  

安装

uv pip install -e .

用法

启动服务器

可用工具

1. get_screen_rightness（）

   • 返回当前屏幕亮度（0-100）

2. set_screen_lightness（亮度：浮动，持续时间：浮动=0）

   • 设置屏幕亮度级别
   • 亮度：目标亮度（0-100）
   • duration：衰减持续时间（秒）（0表示立即更改）

3. get_system_volume（）

   • 返回当前系统卷（0-100）

4. set_system_volume（卷：int）

   • 设置系统音量级别（0-100）

5. toggle_system_mute（）

   • 切换系统音频静音状态

配置

在Claude桌面中配置：

{
    "mac_brightness": {
        "command": "uvx",
        "args": ["mcp-server-mac-brightness"]
    }
}

错误处理

• 亮度和音量级别的输入验证
• 系统API故障的全面错误消息
• 对权限问题进行优雅的错误处理

许可证

MIT许可证