MCP.Market

Divoom LAN Watchface MCP server

by DivoomDevelop·io.github.DivoomDevelop/mcp-divoom-lan·v0.1.1·5 stars
No reviews yet

MCP server for Divoom LAN watchface APIs; read-before-write safe. V2 editor linked in README.

A92/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A92/100

full report

Adoption
Growing

5 stars56 downloads/wk

Reviews

Write one

Nobody has reviewed Divoom LAN Watchface yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Divoom LAN Watchface tools (14, 4 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • watchface_create_local_clockwrite action

    POST /create_local_clock with multipart. Explicit operation only; never auto-triggered by patch flow.

  • watchface_get_brightness

    Call Sys/GetBrightness.

  • watchface_get_fonts_local

    Call Device/GetLocalFontList.

  • watchface_get_local

    Call Device/GetLocalClockInfo for current or explicit clock id.

  • watchface_get_store_market_list

    Call Device/GetStoreClockMarketList after device prefetch has populated in-memory store data.

  • watchface_onoff_screen

    Call Channel/OnOffScreen with OnOff (1=on, 0=off).

  • watchface_patch_localwrite action

    Call Device/PatchLocalClockInfo with precheck. Stops when current ItemList is empty to avoid unsafe patch flow.

  • watchface_protocol_quick_reference

    Return concise operational constraints extracted from the public guide and skill.

  • watchface_raw_command

    Raw POST /divoom_api command wrapper. Command is required; payload object is merged with enforced ReturnCode=0.

  • watchface_replace_dial_bg_filewrite action

    POST /replace_clock_dial_bg using multipart (Device/ReplaceClockDialBgFile). Does not modify DeviceImageUrl.

  • watchface_reset_local_then_cloud

    Call Device/ResetLocalClockFromServer. This deletes local sys-side files before optional cloud refresh.

  • watchface_set_brightness

    Call Channel/SetBrightness with Brightness.

  • watchface_set_clock_select

    Call Channel/SetClockSelectId with ClockId.

  • watchface_upload_filewrite action

    POST /upload with multipart. First JSON part is caller-provided metadata (product-specific Command).

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan3 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 5 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 92/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Divoom LAN Watchface compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
92/100
higher than 95% of 48,255 servers
Tools
14
the typical server has 7
Tools that change things
29%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
5
more than 83% of 28,688 servers
Downloads a week
56
more than 46% of 12,191 servers with a package

What its tools let an agent do: 10 read · 4 change

Install Divoom LAN Watchface in Claude Code, Cursor or VS Code

Runs npx -y mcp-divoom-lan on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add mcp-divoom-lan -- npx -y mcp-divoom-lan
Add to Cursor

What the publisher says

From the Divoom LAN Watchface repository's README, as published. We do not edit it. Read it on GitHub

mcp-divoom-lan

mcp-divoom-lan is an open-source MCP server that wraps Divoom TimesFrame and AstroToo watchface LAN APIs as standard tools for AI clients. One server can control several devices: every operation first reads Device/GetHardwareVersion from that target and selects the product profile from the returned Hardware value.

It works together with the v2 HTML visual editor for modifying watchfaces, switching faces, adjusting brightness, and creating new local watchfaces.

v2 visual editor (public):

  • GitHub: https://github.com/DivoomDevelop/divoom-watchface-visual-editor_v2
  • Live site: https://divoomdevelop.github.io/divoom-watchface-visual-editor_v2/

Your local clone path (e.g. D:\divoom-watchface-visual-editor) is machine-specific; use the v2 GitHub / GitHub Pages URLs above in docs and MCP metadata.

Goals

  • Expose key capabilities from DivoomWatchfaceRemoteCustomizationGuide_EN.md as MCP tools
  • Let MCP-enabled clients (Cursor, Claude Desktop, local LLMs, etc.) drive watchface actions via natural language
  • Preserve safety boundaries (read before write, explicit warnings for risky operations, multipart rules)

Default safety policy (important)

  • Identify every target first: Hardware 510/511/512 selects TimesFrame; 530 selects AstroToo. Unknown hardware is rejected. DeviceType is not used for product detection.
  • Read before write: call watchfacegetlocal, then watchfacepatchlocal, then read back to verify.
  • If GetLocalClockInfo returns an empty ItemList: stop writes; switch to an editable watchface first.
  • Do not call watchfacecreatelocal_clock unless the user clearly asks to create a new one (no implicit creation).

Implemented tools (21)

Device tools (15):

  • watchfacegetdevice_info → hardware identification and LAN capability report
  • watchfacegetlocal → Device/GetLocalClockInfo
  • watchfacepatchlocal → Device/PatchLocalClockInfo (default /divoomapi); optional dialAssetsPath switches to multipart POST /patchlocal_clock. TimesFrame can use tar.gz; AstroToo accepts one backdrop and uses prior per-file local:// uploads for elements.
  • watchfacegetfonts_local → Device/GetLocalFontList
  • watchfacegetstoremarketlist → Device/GetStoreClockMarketList
  • watchfacesetclock_select → Channel/SetClockSelectId (TimesFrame queues a paired request inside one serialized MCP operation so a manual selection suppresses the active traditional schedule for the current period; AstroToo sends once)
  • watchfacegetbrightness → Sys/GetBrightness
  • watchfacesetbrightness → Channel/SetBrightness
  • watchfaceonoffscreen → Channel/OnOffScreen (1=on, 0=off)
  • watchfacereplacedialbgfile → POST /replaceclockdial_bg
  • watchfaceuploadfile → AstroToo-only POST /uploadlocalasset; returns a temporary local:// staging reference consumed by a successful create/patch. AstroToo keeps product photo/pixel POST /upload separate. TimesFrame generic /upload is blocked in local-only MCP mode.
  • watchfacecreatelocalclock → POST /createlocal_clock (TimesFrame: single image or tar.gz; AstroToo: one 480×480 backdrop after uploading element files individually)

Offline/model-aware authoring tools (6):

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Divoom LAN Watchface: common questions

Is Divoom LAN Watchface MCP server safe?
Yes, by our scan: it is graded A (92/100). Read the Divoom LAN Watchface safety report
How do I install Divoom LAN Watchface?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Divoom LAN Watchface need an API key?
No secret keys are declared. It reads 3 settings from the environment.
Is Divoom LAN Watchface maintained?
The last commit was 42 days ago (2026-09-23). The latest release is v0.1.1.
How does Divoom LAN Watchface compare with other MCP servers?
safety score 92/100 (higher than 95% of 48,255 servers); tools 14 (the typical server has 7); tools that change things 29% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.