io.github.cyanheads/pixoo-mcp-server

Official

by cyanheads · TypeScript

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

Render and display pixel art, text, dashboards, and animations on Divoom Pixoo LED screens.

Topics

divoomled-matrixmcpmcp-servermodel-context-protocolpixel-artpixootypescriptanimationiotspritedivoom-pixoopixoo-64pixoo-16pixoo-32cyanheadsai-agentsai-toolsbundisplay

Install

Configuration

Environment variables

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_SIZEdefault 64

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_MSdefault 1000

Minimum interval between device pushes in milliseconds. Prevents device freeze from rapid-fire commands.

MCP_LOG_LEVELdefault info

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

MCP_HTTP_HOSTdefault 127.0.0.1

The hostname for the HTTP server.

MCP_HTTP_PORTdefault 3010

The port to run the HTTP server on.

MCP_HTTP_ENDPOINT_PATHdefault /mcp

The endpoint path for the MCP server.

MCP_AUTH_MODEdefault none

Authentication mode to use: 'none', 'jwt', or 'oauth'.

claude_desktop_config.json

{
  "mcpServers": {
    "pixoo-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/pixoo-mcp-server@1.0.0",
        "run",
        "start:stdio"
      ],
      "env": {
        "PIXOO_IP": "<YOUR_PIXOO_IP>",
        "PIXOO_SIZE": "64",
        "PIXOO_OUTPUT_DIR": "<YOUR_PIXOO_OUTPUT_DIR>",
        "PIXOO_PUSH_MIN_INTERVAL_MS": "1000",
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}