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 分