mac brightness

MCP Mac亮度服务器

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

特性

• 屏幕亮度控制

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

• 系统音量控制

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

需求

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

  brew install brightness

安装

uv pip install -e .

用法

启动服务器

可用工具

1. get_screen_rightness（）

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

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

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

1. get_system_volume（）

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

1. set_system_volume（卷：int）

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

1. toggle_system_mute（）

- 切换系统音频静音状态

配置

在Claude桌面中配置：

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

错误处理

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

许可证

MIT许可证