io.github.cyanheads

pixoo-mcp-server

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

communityapplication

Package Details

Transportstdio
Runtimebun

Package Arguments

Positional
Position 0
run
Position 1
start:stdio

Environment Variables

PIXOO_IP(str)

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(str)
Default:64

Display size in pixels: 16, 32, or 64. Must match the physical device.

PIXOO_OUTPUT_DIR(str)

Directory for auto-saving preview PNG and GIF files. When unset, previews are returned in-response only.

PIXOO_PUSH_MIN_INTERVAL_MS(str)
Default:1000

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

MCP_LOG_LEVEL(str)
Default:info

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

TransportStreamable HTTP
Runtimebun

Package Arguments

Positional
Position 0
run
Position 1
start:http

Environment Variables

PIXOO_IP(str)

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(str)
Default:64

Display size in pixels: 16, 32, or 64. Must match the physical device.

PIXOO_OUTPUT_DIR(str)

Directory for auto-saving preview PNG and GIF files. When unset, previews are returned in-response only.

PIXOO_PUSH_MIN_INTERVAL_MS(str)
Default:1000

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

MCP_HTTP_HOST(str)
Default:127.0.0.1

The hostname for the HTTP server.

MCP_HTTP_PORT(str)
Default:3010

The port to run the HTTP server on.

MCP_HTTP_ENDPOINT_PATH(str)
Default:/mcp

The endpoint path for the MCP server.

MCP_AUTH_MODE(str)
Default:none

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

MCP_LOG_LEVEL(str)
Default:info

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