io.github.biocross/displaybuddy-mcp
MCP server for controlling Mac monitors via DisplayBuddy — adjust brightness and more.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
@biocross/displaybuddy-mcpclaude mcp add displaybuddy-mcp -- npx -y @biocross/displaybuddy-mcp@3.3.0
{
"mcpServers": {
"displaybuddy-mcp": {
"command": "npx",
"args": [
"-y",
"@biocross/displaybuddy-mcp@3.3.0"
]
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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
- macOS with DisplayBuddy installed and running
- DisplayBuddy CLI installed: open DisplayBuddy > Settings > General > Install CLI Tool
- Node.js 18+
Installation
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"displaybuddy": {
"command": "npx",
"args": ["-y", "displaybuddy-mcp"]
}
}
}
Cursor
Add to your MCP settings:
{
"mcpServers": {
"displaybuddy": {
"command": "npx",
"args": ["-y", "displaybuddy-mcp"]
}
}
}
Smithery
npx -y @smithery/cli install displaybuddy-mcp --client claude
Available Tools
| Tool | Description |
|---|---|
displaybuddy_status | Quick overview of all displays (call this first) |
displaybuddy_list | Full display details including UUID, type, capabilities |
displaybuddy_get | Get properties of a specific display |
displaybuddy_set | Set brightness, contrast, volume, input, rotation |
displaybuddy_preset_list | List saved presets |
displaybuddy_preset_activate | Activate a preset (with optional delay) |
displaybuddy_schedule_list | List automation schedules |
displaybuddy_schedule_toggle | Enable or disable a schedule |
displaybuddy_sync | Check/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
npm install
npm run build
# Test with MCP Inspector
npx -y @modelcontextprotocol/inspector node ./build/index.js
License
MIT
Questions fréquentes
Qu'est-ce que io.github.biocross/displaybuddy-mcp ?
MCP server for controlling Mac monitors via DisplayBuddy — adjust brightness and more.
Comment installer io.github.biocross/displaybuddy-mcp ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add displaybuddy-mcp -- npx -y @biocross/displaybuddy-mcp@3.3.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.biocross/displaybuddy-mcp ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
io.github.biocross/displaybuddy-mcp est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.biocross/displaybuddy-mcp ?
Il est publié par biocross. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.