显示器控制服务器

DisplayBuddy MCP Server是一个通过MCP协议让AI代理控制Mac显示器的服务器,支持调整亮度、对比度、音量、输入源等操作,适用于自动化工作流和多显示器管理。

  • by biocross
  • JavaScript
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 biocross/displaybuddy-mcp

使用说明

DisplayBuddy MCP服务器

一 MCP(模型上下文协议) 允许AI代理通过以下方式控制Mac显示器的服务器 DisplayBuddy --调整亮度、对比度、音量、输入源、应用预设、同步显示等。

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

先决条件

  1. macOS 随着 DisplayBuddy 已安装并正在运行
  2. DisplayBuddy命令行界面 已安装:打开DisplayBuddy>设置>常规>安装CLI工具
  3. Node.js 18+

安装

克劳德桌面版

添加到您的 claude_desktop_config.json:

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

光标

添加到MCP设置中:

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

史密瑟里

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%”
  • “连接了哪些显示器?”
  • “将我的戴尔显示器切换到HDMI”
  • “激活我的夜间模式预设”
  • “将所有显示同步到我的主监视器”
  • “提高外部显示器的亮度”
  • “设置我的编码环境——亮度70,对比度60”

运作原理

MCP服务器封装 displaybuddy CLI,它通过URL方案与正在运行的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

许可证

麻省理工学院