Displaybuddy Mcp

io.github.biocross由 GitHub 账号 biocross 发布v1.0.0更新于 Nov 3, 2026

MCP server for controlling Mac monitors via DisplayBuddy — adjust brightness and more.

已验证STDIO仅桌面效率与工作流媒体与设计

概览

AI 生成的概览

本地 MCP 服务器,让 AI 助手通过 DisplayBuddy 控制 Mac 显示器:亮度、对比度、音量、输入源、预设与同步。

可以做什么
  • 查看显示器:获取所有显示器的状态概览、列出包含 UUID、类型与能力的完整信息,以及读取指定显示器的属性
  • 调整显示设置:设置亮度、对比度、音量、输入源与旋转
  • 管理预设:列出已保存的预设并按需激活,可带延迟
  • 管理计划:列出自动化计划并启用或停用
  • 控制多屏同步:检查、启用或停用显示器之间的同步
适用场景
适用于装有多个显示器的 Mac:想通过对话调整亮度、对比度、音量或输入源,切换预设,或同步各显示器,而不必手动操作 DisplayBuddy 应用。
运行要求
macOS,已安装并运行 DisplayBuddy 应用,并在应用设置中安装 DisplayBuddy CLI;npm 包需要 Node.js 18 或更高版本。通过 stdio 本地运行;未声明账号、API 密钥或环境变量。
安装前请注意
它会直接更改显示器的硬件设置(亮度、对比度、音量、输入源、旋转),并可激活预设、切换计划,助手的操作会立即生效。它依赖 DisplayBuddy 应用及其 CLI 已安装;README 称所有操作均在本地进行,数据不会离开本机。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Displaybuddy Mcp,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

DisplayBuddy MCP Server

An MCP (Model Context Protocol) server that lets AI agents control Mac monitors via DisplayBuddy — adjust brightness, contrast, volume, input source, apply presets, sync displays, and more.

Works with Claude Desktop, Cursor, Windsurf, Cline, and any MCP-compatible client.

Prerequisites

  1. macOS with DisplayBuddy installed and running
  2. DisplayBuddy CLI installed: open DisplayBuddy > Settings > General > Install CLI Tool
  3. Node.js 18+

Installation

Claude Desktop

Add to your claude_desktop_config.json:

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

Cursor

Add to your MCP settings:

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

Smithery

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

Available Tools

ToolDescription
displaybuddy_statusQuick overview of all displays (call this first)
displaybuddy_listFull display details including UUID, type, capabilities
displaybuddy_getGet properties of a specific display
displaybuddy_setSet brightness, contrast, volume, input, rotation
displaybuddy_preset_listList saved presets
displaybuddy_preset_activateActivate a preset (with optional delay)
displaybuddy_schedule_listList automation schedules
displaybuddy_schedule_toggleEnable or disable a schedule
displaybuddy_syncCheck/enable/disable multi-display sync

Example Prompts

Once connected, you can ask your AI assistant things like:

  • "Dim all my monitors to 30%"
  • "What displays are connected?"
  • "Switch my Dell monitor to HDMI"
  • "Activate my Night Mode preset"
  • "Sync all displays to my main monitor"
  • "Turn up the brightness on my external display"
  • "Set up my coding environment — brightness 70, contrast 60"

How It Works

The MCP server wraps the displaybuddy CLI, which communicates with the running DisplayBuddy app via URL scheme. All operations are local — no data leaves your machine.

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

Development

bash
npm installnpm run build
# Test with MCP Inspectornpx -y @modelcontextprotocol/inspector node ./build/index.js

License

MIT

来源:README.md,提交 6dc03c4

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分