{"_id":"@biocross/displaybuddy-mcp","_rev":"2-581c33ce7ab2772a8304583a04b33a22","name":"@biocross/displaybuddy-mcp","dist-tags":{"latest":"3.3.0"},"versions":{"3.2.2":{"name":"@biocross/displaybuddy-mcp","version":"3.2.2","keywords":["mcp","monitor","display","brightness","contrast","volume","ddc","macos","displaybuddy"],"author":{"name":"DisplayBuddy"},"license":"MIT","_id":"@biocross/displaybuddy-mcp@3.2.2","maintainers":[{"name":"biocross","email":"sids.1992@gmail.com"}],"homepage":"https://displaybuddy.app","bugs":{"url":"https://github.com/biocross/displaybuddy-mcp/issues"},"bin":{"displaybuddy-mcp":"build/index.js"},"dist":{"shasum":"a33c9e9b22c8d4f370bd2d70600d3da90e957727","tarball":"https://registry.npmjs.org/@biocross/displaybuddy-mcp/-/displaybuddy-mcp-3.2.2.tgz","fileCount":10,"integrity":"sha512-KFcDX+zoxaQs1PSXoqqJRlS/nqRWiX8JAtus+w8yfjT1NG+whQoSZxXOlQ1HjB1D25R+A0vvJpvGxV3MWuvfzQ==","signatures":[{"sig":"MEUCIB+fWvROsnOCyGXA1S+eXRHghkkpF3CXBxefOU9duUYyAiEAjOm/jJSZVr0Gk4mEKGj/UQ6becG9qG4VGTfV40lKWJk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1938179},"main":"build/index.js","type":"module","types":"./build/index.d.ts","mcpName":"io.github.biocross/displaybuddy-mcp","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"biocross","email":"sids.1992@gmail.com"},"repository":{"url":"git+https://github.com/biocross/displaybuddy-mcp.git","type":"git"},"_npmVersion":"11.4.2","description":"MCP server for controlling Mac monitors via DisplayBuddy — adjust brightness, contrast, volume, input source, presets, sync, and more.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/displaybuddy-mcp_3.2.2_1773502785186_0.479443218708439","host":"s3://npm-registry-packages-npm-production"}},"3.3.0":{"name":"@biocross/displaybuddy-mcp","version":"3.3.0","description":"MCP server for controlling Mac monitors via DisplayBuddy — adjust brightness, contrast, volume, input source, presets, sync, and more.","type":"module","main":"build/index.js","mcpName":"io.github.biocross/displaybuddy-mcp","bin":{"displaybuddy-mcp":"build/index.js"},"scripts":{"build":"tsc","prepublishOnly":"npm run build"},"keywords":["mcp","monitor","display","brightness","contrast","volume","ddc","macos","displaybuddy"],"author":{"name":"DisplayBuddy"},"license":"MIT","homepage":"https://displaybuddy.app","repository":{"type":"git","url":"git+https://github.com/biocross/displaybuddy-mcp.git"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.23.0"},"devDependencies":{"@types/node":"^20.0.0","typescript":"^5.0.0"},"_id":"@biocross/displaybuddy-mcp@3.3.0","types":"./build/index.d.ts","bugs":{"url":"https://github.com/biocross/displaybuddy-mcp/issues"},"_nodeVersion":"24.3.0","_npmVersion":"11.4.2","dist":{"integrity":"sha512-gmvqLAlLuizdm/JACn019aHMUwDD1ofr+IiEEur6gPcGtYoKBZaCcB8cEQQW7xKlWczSkAyW3qx0KVttPEZmnw==","shasum":"3a0dc43c93d49d36b85b1b4701f8e1291aec826f","tarball":"https://registry.npmjs.org/@biocross/displaybuddy-mcp/-/displaybuddy-mcp-3.3.0.tgz","fileCount":10,"unpackedSize":1938179,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCu48WZXKAiAHlUXPGRmJ85psknsvryEFQJP4aTe9FLnQIgXvunsLqbD1c4AqzA0C+TzCLR6IO76x8YZ5RSLgYIGjk="}]},"_npmUser":{"name":"biocross","email":"sids.1992@gmail.com"},"directories":{},"maintainers":[{"name":"biocross","email":"sids.1992@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/displaybuddy-mcp_3.3.0_1773502842529_0.9909964664152073"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-14T15:39:45.076Z","modified":"2026-03-14T15:40:42.889Z","3.2.2":"2026-03-14T15:39:45.381Z","3.3.0":"2026-03-14T15:40:42.771Z"},"bugs":{"url":"https://github.com/biocross/displaybuddy-mcp/issues"},"author":{"name":"DisplayBuddy"},"license":"MIT","homepage":"https://displaybuddy.app","keywords":["mcp","monitor","display","brightness","contrast","volume","ddc","macos","displaybuddy"],"repository":{"type":"git","url":"git+https://github.com/biocross/displaybuddy-mcp.git"},"description":"MCP server for controlling Mac monitors via DisplayBuddy — adjust brightness, contrast, volume, input source, presets, sync, and more.","maintainers":[{"name":"biocross","email":"sids.1992@gmail.com"}],"readme":"# DisplayBuddy MCP Server\n\nAn [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that lets AI agents control Mac monitors via [DisplayBuddy](https://displaybuddy.app) — adjust brightness, contrast, volume, input source, apply presets, sync displays, and more.\n\nWorks with Claude Desktop, Cursor, Windsurf, Cline, and any MCP-compatible client.\n\n## Prerequisites\n\n1. **macOS** with [DisplayBuddy](https://displaybuddy.app) installed and running\n2. **DisplayBuddy CLI** installed: open DisplayBuddy > Settings > General > Install CLI Tool\n3. **Node.js** 18+\n\n## Installation\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"displaybuddy\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"displaybuddy-mcp\"]\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to your MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"displaybuddy\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"displaybuddy-mcp\"]\n    }\n  }\n}\n```\n\n### Smithery\n\n```bash\nnpx -y @smithery/cli install displaybuddy-mcp --client claude\n```\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `displaybuddy_status` | Quick overview of all displays (call this first) |\n| `displaybuddy_list` | Full display details including UUID, type, capabilities |\n| `displaybuddy_get` | Get properties of a specific display |\n| `displaybuddy_set` | Set brightness, contrast, volume, input, rotation |\n| `displaybuddy_preset_list` | List saved presets |\n| `displaybuddy_preset_activate` | Activate a preset (with optional delay) |\n| `displaybuddy_schedule_list` | List automation schedules |\n| `displaybuddy_schedule_toggle` | Enable or disable a schedule |\n| `displaybuddy_sync` | Check/enable/disable multi-display sync |\n\n## Example Prompts\n\nOnce connected, you can ask your AI assistant things like:\n\n- \"Dim all my monitors to 30%\"\n- \"What displays are connected?\"\n- \"Switch my Dell monitor to HDMI\"\n- \"Activate my Night Mode preset\"\n- \"Sync all displays to my main monitor\"\n- \"Turn up the brightness on my external display\"\n- \"Set up my coding environment — brightness 70, contrast 60\"\n\n## How It Works\n\nThe 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.\n\n```\nAI Agent → MCP Server → displaybuddy CLI → DisplayBuddy App → Your Monitors\n```\n\n## Development\n\n```bash\nnpm install\nnpm run build\n\n# Test with MCP Inspector\nnpx -y @modelcontextprotocol/inspector node ./build/index.js\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}