送信

Mcp Divoom TimeFrame Lan

@DivoomDevelop

mcp-divoom-lan is an open-source Model Context Protocol (MCP) server that exposes Divoom watchface customization over local LAN HTTP. AI assistants can read and patch the current on-device watchface JSON, manage fonts and store market lists, switch the active dial, adjust brightness, and run multipart flows for background replacement, file upload, and creating a local clock—while following a read-before-write workflow and explicit warnings for destructive actions (e.g. reset-from-cloud). Requires network access to the Divoom device; configure DIVOOM_DEVICE_HOST (and optionally port/timeout). MIT license; Node.js 20+; stdio transport.
概要

mcp-divoom-lan

Open-source Model Context Protocol (MCP) server for Divoom watchface customization over local LAN HTTP. Use it from Cursor, Claude Desktop, or any MCP-compatible client to drive on-device watchface workflows in natural language.

What it does

  • Read and patch the current local watchface (GetLocalClockInfo / PatchLocalClockInfo)
  • List local fonts and store / market dials
  • Switch active dial and read/set brightness
  • Multipart helpers for dial background replacement, file upload, and creating a local clock
  • Exposes MCP resources with concise protocol / safety notes for agents

Requirements

  • Node.js 20+
  • Network access to the Divoom device (same LAN as the HTTP API, commonly port 9000)

Configuration

Set environment variables (or pass target per tool call):

VariableRole
DIVOOM_DEVICE_HOSTDevice IP on LAN (recommended)
DIVOOM_DEVICE_PORTHTTP port (default 9000)
DIVOOM_TIMEOUT_MSTimeout ms (default 45000)

Safety

  • Prefer read → patch → read back before trusting changes.
  • Some operations (e.g. reset from cloud) can be destructive; confirm with the user first.

License

MIT

サーバー設定

{
  "mcpServers": {
    "divoom-lan": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-divoom-lan"
      ],
      "env": {
        "DIVOOM_DEVICE_HOST": "192.168.1.120",
        "DIVOOM_DEVICE_PORT": "9000",
        "DIVOOM_TIMEOUT_MS": "45000"
      }
    }
  }
}