bezelbub-mcp — Claude Code MCP server: Apple device frames
Wraps screenshots and screen recordings in iPhone, iPad, Mac and Apple TV bezels. macOS only.
claude mcp add bezelbub-mcp -- npx -y @dgr_labs/bezelbub-mcpWhat bezelbub-mcp does
The server hands your agent the Bezelbub framing engine. Give it an image and it works out the device from the pixel size, then applies the matching bezel. iPhones and iPads are matched on exact screen resolution; Macs, iMac, Studio Display and Apple TV are matched on capture size, so any macOS display zoom setting works. Unknown sizes fall back to aspect-ratio matching.
You can also spell out --device, --color, --orientation, --background and --output-size. Output can be JSON, and a failed call returns a distinct nonzero exit code with a suggestion on stderr — valid ids, nearest devices by proportions. Useful when the call comes from a shell script or CI and nobody is reading logs by hand.
Transparent video comes out as HEVC with alpha in a QuickTime .mov. A VP9/WebM copy for Chrome and Firefox is built by handing a ProRes 4444 master to ffmpeg, which has to be on your PATH or that step fails. The whole thing is macOS-bound.
What it helps with
- frame an app screenshot in the right iPhone bezel
- produce a device mockup for a product page
- add a bezel to a screen recording and keep the audio
- export a framed clip with a transparent background
- list available device ids and colors as JSON
Example prompts for the agent
- Frame
shot.pngin an iPhone 17 Pro bezel, Cosmic Orange - Turn
demo.mp4into a transparent-background video and add a WebM copy - Which devices fit this screenshot?
How to install bezelbub-mcp
Platform CLI
claude mcp add bezelbub-mcp -- npx -y @dgr_labs/bezelbub-mcpPlatform CLI
codex mcp add bezelbub-mcp -- npx -y @dgr_labs/bezelbub-mcpConfig file
{
"mcpServers": {
"bezelbub-mcp": {
"command": "npx",
"args": [
"-y",
"@dgr_labs/bezelbub-mcp"
]
}
}
}Config file
{
"servers": {
"bezelbub-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@dgr_labs/bezelbub-mcp"
]
}
}
}Platform CLI
gemini mcp add bezelbub-mcp npx -y @dgr_labs/bezelbub-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about bezelbub-mcp
How do I install bezelbub-mcp in Claude Code?
Run claude mcp add bezelbub-mcp -- npx -y @dgr_labs/bezelbub-mcp.
What does bezelbub-mcp do?
It puts screenshots and screen recordings inside Apple device bezels. The device is detected from the image size, and you can override it by hand.
What does bezelbub-mcp need to run?
macOS. The WebM alpha copy additionally needs ffmpeg on your PATH.
