MCP SERVERPut styled text, layered scenes and animations on a Divoom Pixoo LED display, and see the rendered frame come back before it reaches the device.
LABSCO SUMMARY
That is the difference between driving a display blind and iterating on it: the frame returns as an image content block, so a scene can be adjusted before anyone looks at the hardware. The design brief tool is an unusual and sensible addition — legibility rules and an animation budget for a 64-pixel grid, delivered before the first attempt rather than after three bad ones. Two things are not previewable and worth knowing: the scrolling overlay uses the device's own font rendering, and the minimum push interval exists because the hardware will freeze if you hammer it.
A control and rendering server for Divoom Pixoo LED displays on your local network. Seven tools cover text, full scene composition, images, device-native overlays and device state — and the render tools return the frame as an image block so you inspect what the display will show.
A Divoom Pixoo display — Pixoo-64, Pixoo-32 or Pixoo-16 — on the same network as the server, and its IP in PIXOO_IP. Run discovery once to find it; that call reaches Divoom's cloud endpoint, so it needs internet, while everything after it is local. PIXOO_SIZE tells the renderer whether the grid is 16, 32 or 64. Bun v1.3.2 or newer, or Node.js v24+, launched with bunx or npx @cyanheads/pixoo-mcp-server; a Docker image and an HTTP transport on port 3010 are the alternatives. Rendering with push disabled works with no device configured at all — useful for previewing before the hardware is on the desk. PIXOO_PUSH_MIN_INTERVAL_MS defaults to 1000 and exists to stop rapid-fire commands freezing the device.
One command — npx -y @cyanheads/pixoo-mcp-server
USE CASES
Find the device on the network, set its IP, then read back its brightness and channel to confirm.
Styled text with auto-fit, and the rendered frame comes back so you can see it fits.
Layer widgets, icons and text into one scene rather than pushing frames one at a time.
Pick the kernel for the content — nearest-neighbour for pixel art, lanczos3 for a photo — and check the downsample before pushing.
A device-native overlay persists across channel switches until you clear it.
Set brightness or the screen state in one call, and read the current state back.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
pixoo_compose_sceneCompose a full scene: layered elements (text, icons, widgets, shapes, bitmaps, images, sprites) with per-element effects and keyframes, static or animated. Returns the rendered scene as an image content block for immediate inspection. Elements render back-to-front in array order. For text-only display use pixoo_display_text; run pixoo_design_brief with topic "scene" or "dashboard" for layout and palette guidance.
pixoo_control_deviceRead or change device state: brightness (0–100), screen on/off, channel, or clock face. Call with no params to read current state only. Supply any params to apply changes before reading back state. Use pixoo_discover_devices first if PIXOO_IP is not yet configured.
pixoo_design_briefReturn craft guidance and live device context for a design topic. Covers legibility rules, palette discipline, layout zones, animation budget, and pre-filled next-tool suggestions based on current device state. The orientation tool to run before authoring a scene, dashboard, or animation — or when troubleshooting display issues.
pixoo_discover_devicesFind Pixoo devices on the local network via Divoom's cloud discovery endpoint (requires internet — queries app.divoom-gz.com). Run once during initial setup to find device IPs; set PIXOO_IP in server configuration to enable all other tools. For ongoing device control use pixoo_control_device.
pixoo_display_textRender styled text (theme, gradient, shadow, outline, auto-fit) onto the Pixoo display and push it. Returns the rendered frame as an image content block for immediate inspection. The primary tool for text-only display — for layers, icons, widgets, or animations use pixoo_compose_scene. Run pixoo_design_brief with topic "text" first for palette and legibility guidance.
pixoo_overlay_textSet or clear a device-native scrolling text overlay. Use mode "set" to add or update an overlay on a slot (0–19); use mode "clear" to remove it. Overlays use device-rendered fonts (115 font IDs, 0–114) and persist across channel switches until explicitly cleared with mode "clear". Not previewable — rendering happens on-device. Best for persistent tickers over pushed scenes; for styled, previewable text use pixoo_display_text instead.
pixoo_push_imageLoad an image (absolute local path or https URL), resize it to fit the LED grid, and optionally push it to the display. Returns the downsampled result as an image content block so you see exactly what the display received. Nearest-neighbor kernel preserves pixel art; use lanczos3 or mitchell for photos.
BEFORE YOU INSTALL
7 tools when we connected.
A Divoom Pixoo LED matrix display on the local network (Pixoo-64, Pixoo-32, or Pixoo-16)
CONTEXT COST
Rated by the size of the 7 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Add the block to your client, or run the command directly.
{
"mcpServers": {
"pixoo-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/pixoo-mcp-server"
]
}
}
}npx -y @cyanheads/pixoo-mcp-serverMCP servers
mcp2everything
voska
whats2000
avrabe