Home › Other › pixoo-mcp-server

pixoo-mcp-server

Render and push styled pixel art, text, dashboards, and animations to Divoom Pixoo LED displays.

TypeScript

★ 10 stars Last pushed 2026-10-29 License: Apache-2.0

View repository →

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (npm 1.5.0)

npx -y @cyanheads/[email protected]

Or add to your MCP client config:

{
  "mcpServers": {
    "pixoo-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/[email protected]"
      ],
      "env": {
        "PIXOO_IP": "<YOUR_VALUE>",
        "PIXOO_SIZE": "<YOUR_VALUE>",
        "PIXOO_OUTPUT_DIR": "<YOUR_VALUE>",
        "PIXOO_PUSH_MIN_INTERVAL_MS": "<YOUR_VALUE>",
        "PIXOO_SERVE_HOST": "<YOUR_VALUE>",
        "PIXOO_SERVE_PORT": "<YOUR_VALUE>",
        "PIXOO_BROWSER_PATH": "<YOUR_VALUE>",
        "PIXOO_HTML_ENABLED": "<YOUR_VALUE>",
        "MCP_LOG_LEVEL": "<YOUR_VALUE>"
      }
    }
  }
}

PIXOO_IP — Device IP address on the local network (e.g. 192.168.1.50). Required for device tools; discovery and pure-render (push: false) work without it.
PIXOO_SIZE — Display size in pixels: 16, 32, or 64. Must match the physical device.
PIXOO_OUTPUT_DIR — Directory for auto-saving preview PNG and GIF files. When unset, previews are returned in-response only.
PIXOO_PUSH_MIN_INTERVAL_MS — Minimum interval between device pushes in milliseconds. Prevents device freeze from rapid-fire commands.
PIXOO_SERVE_HOST — Host advertised in the URL the device downloads an animation of more than 40 frames from, for NAT or a DNS name. When unset, the local address the OS routes to PIXOO_IP; the listener binds that address either way.
PIXOO_SERVE_PORT — Fixed port for the listener the device downloads an animation of more than 40 frames from, for firewall rules. When unset, a free port.
PIXOO_BROWSER_PATH — Browser executable for HTML rendering, such as the chrome-headless-shell that `npx @puppeteer/browsers install chrome-headless-shell@stable --path <dir>` installs. When set, the only browser tried: a path that is not an executable file fails rather than falling back. When unset, the newest chrome-headless-shell in Puppeteer's cache (~/.cache/puppeteer).
PIXOO_HTML_ENABLED — Offer pixoo_render_html. false (or 0, no, off) disables it, removing it from tools/list; unset or true keeps it. A value that is not one of those boolean spellings fails startup.
MCP_LOG_LEVEL — Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Package (npm 1.5.0)

Package: npm @cyanheads/pixoo-mcp-server

MCP_TRANSPORT_TYPE — Selects the HTTP transport.
PIXOO_IP — Device IP address on the local network (e.g. 192.168.1.50). Required for device tools; discovery and pure-render (push: false) work without it.
PIXOO_SIZE — Display size in pixels: 16, 32, or 64. Must match the physical device.
PIXOO_OUTPUT_DIR — Directory for auto-saving preview PNG and GIF files. When unset, previews are returned in-response only.
PIXOO_PUSH_MIN_INTERVAL_MS — Minimum interval between device pushes in milliseconds. Prevents device freeze from rapid-fire commands.
PIXOO_SERVE_HOST — Host advertised in the URL the device downloads an animation of more than 40 frames from, for NAT or a DNS name. When unset, the local address the OS routes to PIXOO_IP; the listener binds that address either way.
PIXOO_SERVE_PORT — Fixed port for the listener the device downloads an animation of more than 40 frames from, for firewall rules. When unset, a free port.
PIXOO_BROWSER_PATH — Browser executable for HTML rendering, such as the chrome-headless-shell that `npx @puppeteer/browsers install chrome-headless-shell@stable --path <dir>` installs. When set, the only browser tried: a path that is not an executable file fails rather than falling back. When unset, the newest chrome-headless-shell in Puppeteer's cache (~/.cache/puppeteer).
PIXOO_HTML_ENABLED — Offer pixoo_render_html. false (or 0, no, off) disables it, removing it from tools/list; unset or true keeps it. A value that is not one of those boolean spellings fails startup.
MCP_HTTP_HOST — The hostname for the HTTP server.
MCP_HTTP_PORT — The port to run the HTTP server on.
MCP_HTTP_ENDPOINT_PATH — The endpoint path for the MCP server.
MCP_AUTH_MODE — Authentication mode to use: 'none', 'jwt', or 'oauth'.
MCP_LOG_LEVEL — Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').