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
Описание
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
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:
- Diagnose Zigbee2MQTT (
z2m), Home Assistant ZHA (zigpy-znp,bellows), and OpenThread RCP logs (analyze_zigbee_thread_log), including Trust CenterZ3_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. - Decode hardware radio/UART status registers (
decode_silicon_register) for TI SimpleLink F2 (CC2652P,CC2652P7,CC1352P7,CC2674P10) and Silicon Labs EFR32 (EFR32MG21,EFR32MG24). - Evaluate Zigbee/Thread mesh coordinator capacity and hardware table limits (
check_coordinator_capacity). - 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-mcpincludes diagnostic rules (0x72,0xa1,ASH_NCP_FATAL_ERROR) andEUSART0_IFregister 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 codes225/233/240/241,0x10,0x11,0xC7,0xCD,0xA7/0xAD,6000msSRSP, 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 forSLZB-06,SLZB-MR2,SLZB-06P7,SLZB-07P7,SLZB-MR1,SLZB-06P10,SLZB-07P10,SLZB-MR3,SLZB-MR4,SLZB-MRW10,SLZB-Ultima(incl.Uvariants), or"all".
Resources & Prompts
zerostack://benchmarks/summary— Complete Part 1 & Part 2DWT->CYCCNTbenchmark 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.
Установка zerostack-rf/zerostack-mcp
У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.
▸ github.com/zerostack-rf/zerostack-mcpFAQ
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
GitHub
PRs, issues, code search, CI status
автор: GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
автор: mcpdotdirectServer Sequential Thinking
MCP server for sequential thinking and problem solving
автор: GitHub ActionsUnyly Deploy
Deploy sites and MCP servers to Unyly straight from your AI agent
автор: UnylyAmap Maps Mcp Server
MCP server for using the AMap Maps API
автор: duxiaohuiPayMCP
Lightweight payments layer for MCP servers: turn tools into paid endpoints with a two-line decorator. [PyPI](https://pypi.org/project/paymcp/) · [npm](https://w
автор: blustAIServer For Power BI
Enables exploring Microsoft Fabric / Power BI workspaces and semantic models, and executing ad-hoc DAX queries.
автор: Mitsubishi-FusoGpt Image 2 Mcp
RunAPI GPT Image 2 MCP server for image generation: create tasks, poll results, and check pricing across 1 model from Claude Code, Codex, Cursor, and VS Code.
автор: runapi-aiCompare zerostack-rf/zerostack-mcp with
Не уверен что выбрать?
Найди свой стек за 60 секунд
Автор?
Embed-бейдж для README
Похожее
Все в категории development
