Command Palette

Search for a command to run...

UnylyUnyly
Весь каталог

zerostack-rf/zerostack-mcp

БесплатноНе проверен

Deterministic root-cause diagnostics for Zigbee2MQTT, Home Assistant ZHA, OpenThread, and IEEE 802.15.4 logs, silicon register decoding for TI SimpleLink F2 and

GitHubEmbed

Описание

Deterministic root-cause diagnostics for Zigbee2MQTT, Home Assistant ZHA, OpenThread, and IEEE 802.15.4 logs, silicon register decoding for TI SimpleLink F2 and Silicon Labs EFR32 coordinators, mesh capacity checks, and DWT->CYCCNT benchmarks.

README

SMLIGHT ZeroStack — Deterministic Zigbee 3.0 Firmware & RF Diagnostics

ZeroStack RF Diagnostics & Benchmark MCP Server (zerostack-mcp)

Official ZeroStack Overview & Downloads: https://smlight.tech/software/zerostack Interactive Web Log Analyzer: https://smlight-tech.github.io/zerostack/ Engineering Whitepaper & Benchmarks: WHITEPAPER.md (Part 1 PDF) Target Firmware: ZeroStack Release Zero

zerostack-mcp is an open-source Model Context Protocol (MCP) server that gives AI coding assistants and home-automation troubleshooting agents (Claude Desktop, Cursor, Windsurf, Cline, OpenAI Agents, Home Assistant AI agents) deterministic tools to:

  1. Diagnose Zigbee2MQTT (z2m), Home Assistant ZHA (zigpy-znp, bellows), and OpenThread RCP logs (analyze_zigbee_thread_log), including Trust Center Z3_TCLK_EXCHANGE_TIMEOUT_LEAVE (BDB_TC_LINK_KEY_EXCHANGE / APS_UpdateDevice / TransportKey) loops, Many-to-One Concentrator routing, and idempotent cold-boot NVRAM backup & restore health.
  2. Decode hardware radio/UART status registers (decode_silicon_register) for TI SimpleLink F2 (CC2652P, CC2652P7, CC1352P7, CC2674P10) and Silicon Labs EFR32 (EFR32MG21, EFR32MG24).
  3. Evaluate Zigbee/Thread mesh coordinator capacity and hardware table limits (check_coordinator_capacity).
  4. Query verified hardware validation benchmarks (DWT->CYCCNT @ 48.0 MHz) (get_zerostack_benchmarks) comparing ZeroStack Release Zero against legacy TI Z-Stack (ZNP 3.x) across SMLIGHT TI SimpleLink F2 coordinators.

Quick Start

Run with uvx (No Installation Required)

{
  "mcpServers": {
    "zerostack-rf": {
      "command": "uvx",
      "args": ["zerostack-mcp"]
    }
  }
}

Local Development Installation

git clone https://github.com/zerostack-rf/zerostack-mcp.git
cd zerostack-rf-mcp
uv sync
uv run pytest
uv run zerostack-mcp

Supported Hardware — Release Zero

ZeroStack Release Zero supports the TI SimpleLink F2 family across SMLIGHT coordinators (Zigbee 3.0 / PRO R23 Coordinator & Router firmware with DMA-driven UART transport, incl. U variants):

Radio SoC CPU Core Flash / SRAM Supported SMLIGHT Models (incl. U variants) Capacity & Scaling
TI CC2652P ARM Cortex-M4F @ 48 MHz + Cortex-M0 CPE 352 KB Flash / 88 KB SRAM SLZB-06, SLZB-MR2 200-node table capacity, high-density source routes, indirect queue quota isolation
TI CC2652P7 (CC1352P7) ARM Cortex-M4F @ 48 MHz + Cortex-M0 CPE 704 KB Flash / 144 KB SRAM SLZB-06P7, SLZB-07P7, SLZB-MR1 300-node table & TCLK capacity, high-density source routes, indirect queue isolation
TI CC2674P10 ARM Cortex-M33 @ 48 MHz + Cortex-M0 CPE 1024 KB Flash / 256 KB SRAM SLZB-06P10, SLZB-07P10, SLZB-MR3, SLZB-MR4, SLZB-MRW10, SLZB-Ultima Max-scale node & TCLK capacity, expanded concentrator source routing & indirect buffer pools

Note on Silicon Labs EFR32 (EFR32MG21 / EFR32MG24): zerostack-mcp includes diagnostic rules (0x72, 0xa1, ASH_NCP_FATAL_ERROR) and EUSART0_IF register decoding for Silicon Labs EmberZNet / EZSP coordinators (SLZB-06M, SLZB-06Mg24, SkyConnect/ZBT-1). ZeroStack Release Zero ships on SMLIGHT TI SimpleLink F2 coordinators; Silicon Labs EFR32 support is in active development.


Verified Hardware Validation Benchmarks (TI CC1352P7 @ 48.0 MHz, DWT->CYCCNT)

Part 1: Deterministic Execution Latency (1 µs = 48 cycles)

Subsystem / Operation Legacy TI Z-Stack (ZNP 3.x) ZeroStack Release Zero Measured Improvement
TCLK Lookup (300-entry table, miss / first contact) 1,486,228 cyc (30.96 ms) 326 cyc (6.8 µs) 4,559× faster (0 flash reads)
TCLK Lookup (300-entry table, oldest-record hit, age 383) 620,396 cyc (12.92 ms) 324 cyc (6.75 µs) 1,915× faster (Slot 0: 7.1×, Slot 299: 9.1×)
Per-Frame NWK Encrypt (D=150) 533,156 cyc (11.11 ms) 3,968 cyc (82.7 µs) 134.4× faster (O(1), 0 flash reads)
Per-Frame NWK Decrypt (D=150) 532,182 cyc (11.09 ms) 3,824 cyc (79.7 µs) 139.2× faster (O(1), 0 flash reads)
Routed Hop Security Ceiling (D=150, Decrypt + Encrypt) 22.19 ms (~45 pkt/s ceiling) 162 µs (7,792 cyc, >6,100 pkt/s) 135× higher ceiling
Per-Frame APS TX Security (300-peer table, D=0..100) 52,909–409,301 cyc (8.53 ms) 5,410–5,424 cyc (113 µs) Up to 75.5× faster
Device Authentication Check (Slot 0 -> 299) 1,656 -> 42,243 cyc (880 µs) 181 -> 179 cyc (3.7 µs) 236× faster
NVM Stack Key Read (D = 0 -> 150) 2,347 -> 64,817 cyc (1.35 ms) 302–303 cyc (6.3 µs) 213.9× faster
Idempotent NVM State Write (Unchanged 100 B, 48 writes) 100,714 cyc (writes flash 48/48) 3,770 cyc (0 B flash 48/48) 26.7× faster + 0% flash wear
NVM Compaction Frequency Write #69 Write #1,013 14.7× lower compaction frequency
Dynamic Memory Allocation (malloc @ k=64 holes) 2,550 cyc 218 cyc (O(1) constant time) 11.7× faster
Timer Start Latency (T=39 timers, 64 heap holes) 10,034 cyc (209.0 µs) 1,448 cyc (30.2 µs, heap-independent) 6.9× faster
Inter-Task Event Enqueue (msgSend, Q=64 queued) 935 cyc 322 cyc (O(1) flat) 2.9× faster
Host Serial Round-Trip (SYS_PING) Legacy baseline 53% fewer total cycles 53% fewer total / 83% fewer reply

Part 2: Adversarial Resilience & Fault Recovery

Stress Vector Legacy TI Z-Stack (ZNP 3.x) ZeroStack Release Zero Measured Improvement
Malformed Secured OTA Frames (12 NWK/APS classes + 3,255 MAC vectors) Uncaught frame processing exception 0 crashes (320–6,631 cyc; 790 cyc / 16 µs routing reject) Zero remote crash + 9.8×–402× lower CPU
1,000-Frame Cryptographic Replay Flood (D=150) 143,802 cyc (3.0 ms)/replay (2.99 s lockup) 1,550 cyc (32 µs)/replay (32.4 ms total) 92.8× faster (30× faster auth tamper reject)
NOR Flash Brownout Fuzzing (22,959 HW cuts + 2M shadow ops) 1 verify conflict; torn-record reboot writes 20,232 B (62 erases) 0 corrupted records; torn reboot writes 27 B (0 erases) 749× lower post-brownout flash write volume
Hostile UART Framing Abuse (6 scenarios) 8.84 s serial link blackout (44 lost pings on 300 × SOF) 0 lost pings (3–55 ms wire-speed recovery, Δheap = 0 B) Zero blackout (29 ms on 300 × SOF, 3 ms truncated)
50-Device Unauthenticated Join / TCLK Miss Flood (D=300) 33.9 ms/miss (1.70 s total stall) 4 µs (208 cyc; 4.3 ms UART RTT, 0.22 s total) 7.7× faster end-to-end
1,000-Frame 50-Router Echo Amplification Storm (D=150) 143,865 cyc (3.00 ms)/echo (3.00 s total CPU) 7,076 cyc (147 µs p50, 151.16 ms total CPU) 19.9× lower total CPU (20.3× faster/echo)
64-Frame Post-Outage Unique Broadcast Flood (D=150) 200.25 ms total, 3.01 ms shed Expanded broadcast table, 18.87 ms total, 174 µs shed 10.6× lower CPU time (17.3× faster shed)

MCP Tools, Resources & Prompts

Tools

All tools include read-only, idempotent ToolAnnotations (readOnlyHint=True, idempotentHint=True, destructiveHint=False, openWorldHint=False):

  • analyze_zigbee_thread_log(log_text): Matches raw Z2M/ZHA/OpenThread logs against 16+ error signatures (including decimal Z2M MAC codes 225/233/240/241, 0x10, 0x11, 0xC7, 0xCD, 0xA7/0xAD, 6000ms SRSP, and multi-line ZCL MQTT delta-zero telemetry floods).
  • decode_silicon_register(chip, register_or_addr, hex_value): Decodes TI SimpleLink F2 (CMD_IEEE_RX, CMD_IEEE_CSMA, RFC_DBELL, VIMS, PRCM) and Silicon Labs EFR32 (EUSART0_IF).
  • check_coordinator_capacity(device_count, sleepy_zed_count, chip_family): Evaluates TI SimpleLink F2 sleepy child capacity, indirect queue isolation, zero flash-read stalls during sleepy poll windows, and SRAM heap headroom.
  • get_zerostack_benchmarks(platform): Returns Part 1 and Part 2 hardware validation benchmarks for SLZB-06, SLZB-MR2, SLZB-06P7, SLZB-07P7, SLZB-MR1, SLZB-06P10, SLZB-07P10, SLZB-MR3, SLZB-MR4, SLZB-MRW10, SLZB-Ultima (incl. U variants), or "all".

Resources & Prompts

  • zerostack://benchmarks/summary — Complete Part 1 & Part 2 DWT->CYCCNT benchmark dataset.
  • zerostack://hardware/supported-models — Supported TI SimpleLink F2 hardware matrix for Release Zero.
  • zerostack://diagnostics/catalog — Full machine-readable ZeroStack diagnostics catalog.
  • Prompt diagnose_zigbee_log(log_text) — Structured troubleshooting workflow for Zigbee2MQTT / ZHA logs.

License

Apache License 2.0 (Apache-2.0) — Copyright (c) 2026 SMLIGHT / ZeroStack RF Engineering. Learn more at https://smlight.tech/software/zerostack.

from github.com/zerostack-rf/zerostack-mcp

Установка zerostack-rf/zerostack-mcp

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/zerostack-rf/zerostack-mcp

FAQ

zerostack-rf/zerostack-mcp MCP бесплатный?

Да, zerostack-rf/zerostack-mcp MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для zerostack-rf/zerostack-mcp?

Нет, zerostack-rf/zerostack-mcp работает без API-ключей и переменных окружения.

zerostack-rf/zerostack-mcp — hosted или self-hosted?

Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.

Как установить zerostack-rf/zerostack-mcp в Claude Desktop, Claude Code или Cursor?

Открой zerostack-rf/zerostack-mcp на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Похожие MCP

Compare zerostack-rf/zerostack-mcp with

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории development