Displaybuddy

DisplayBuddy MCP 服务

一个 MCP（Model Context Protocol） 服务，可让 AI Agent 通过 DisplayBuddy 控制 Mac 显示器——调节亮度、对比度、音量和输入源，应用预设，同步显示器等。

适用于 Claude Desktop、Cursor、Windsurf、Cline 以及任何兼容 MCP 的客户端。

前置条件

1. 安装并运行 DisplayBuddy 的 macOS
2. 安装 DisplayBuddy CLI：打开 DisplayBuddy > Settings > General > Install CLI Tool
3. Node.js 18+

安装

Claude Desktop

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "displaybuddy": {
      "command": "npx",
      "args": ["-y", "displaybuddy-mcp"]
    }
  }
}

Cursor

添加到你的 MCP 设置中：

{
  "mcpServers": {
    "displaybuddy": {
      "command": "npx",
      "args": ["-y", "displaybuddy-mcp"]
    }
  }
}

Smithery

npx -y @smithery/cli install displaybuddy-mcp --client claude

可用工具

工具	描述
displaybuddy_status	快速查看所有显示器的概况（先调用此工具）
displaybuddy_list	显示器完整详情，包括 UUID、类型和功能
displaybuddy_get	获取指定显示器的属性
displaybuddy_set	设置亮度、对比度、音量、输入源和旋转
displaybuddy_preset_list	列出已保存的预设
displaybuddy_preset_activate	激活预设（可选延迟）
displaybuddy_schedule_list	列出自动化计划
displaybuddy_schedule_toggle	启用或禁用计划
displaybuddy_sync	检查、启用或禁用多显示器同步

示例提示词

连接后，你可以向 AI 助手提出以下请求：

• “将我所有显示器的亮度调到 30%”
• “连接了哪些显示器？”
• “将我的 Dell 显示器切换到 HDMI”
• “启用我的夜间模式预设”
• “将所有显示器同步到我的主显示器”
• “调高外接显示器的亮度”
• “设置我的编码环境——亮度 70，对比度 60”

工作原理

此 MCP 服务封装了 displaybuddy CLI，该 CLI 通过 URL scheme 与正在运行的 DisplayBuddy 应用通信。所有操作都在本地进行——数据不会离开你的设备。

AI Agent → MCP Server → displaybuddy CLI → DisplayBuddy App → Your Monitors

开发

npm install
npm run build

# Test with MCP Inspector
npx -y @modelcontextprotocol/inspector node ./build/index.js

许可证

MIT