Sparkplug B

Name: Sparkplug B
Author: nagarjunr

de nagarjunrversión 0.1.0i★ –iSe ejecuta en tu computadora

Nombre en el registroio.github.nagarjunr/sparkplug-b

Instalar

Resumen

Descripción del creador (original en inglés)

MCP server for Sparkplug B: node/device discovery, metrics, commands, host state over MQTT.

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi1 de 1 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiAún sin medir★ –

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Se ejecuta en tu computadora
Transporte: stdio
Categoría: Otros
Debes completar: SPARKPLUG_MQTT_HOST, SPARKPLUG_HOST_ID, SPARKPLUG_MQTT_PASSWORD

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 1 de 1 superadas
Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
Debes completar tú: SPARKPLUG_MQTT_HOST, SPARKPLUG_HOST_ID, SPARKPLUG_MQTT_PORT, SPARKPLUG_MQTT_USERNAME, SPARKPLUG_MQTT_PASSWORD, SPARKPLUG_MQTT_USE_TLS, SPARKPLUG_GROUP_ID

Los valores marcados como secretos son llaves de tu cuenta. Nunca los compartas ni los pegues en un chat.

Necesitas

PyPIuv de Python instalado (para el comando uvx)

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json

{
  "mcpServers": {
    "sparkplug-b": {
      "command": "uvx",
      "args": [
        "sparkplug-b-mcp-server"
      ],
      "env": {
        "SPARKPLUG_MQTT_HOST": "your-value",
        "SPARKPLUG_HOST_ID": "your-value",
        "SPARKPLUG_MQTT_PORT": "your-value",
        "SPARKPLUG_MQTT_USERNAME": "your-value",
        "SPARKPLUG_MQTT_PASSWORD": "your-value",
        "SPARKPLUG_MQTT_USE_TLS": "your-value",
        "SPARKPLUG_GROUP_ID": "your-value"
      }
    }
  }
}

Ejecuta esto en tu terminal

claude mcp add sparkplug-b --env SPARKPLUG_MQTT_HOST=your-value --env SPARKPLUG_HOST_ID=your-value --env SPARKPLUG_MQTT_PORT=your-value --env SPARKPLUG_MQTT_USERNAME=your-value --env SPARKPLUG_MQTT_PASSWORD=your-value --env SPARKPLUG_MQTT_USE_TLS=your-value --env SPARKPLUG_GROUP_ID=your-value -- uvx sparkplug-b-mcp-server

Completa los valores vacíos antes de ejecutarlo.

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

{
  "mcpServers": {
    "sparkplug-b": {
      "command": "uvx",
      "args": [
        "sparkplug-b-mcp-server"
      ],
      "env": {
        "SPARKPLUG_MQTT_HOST": "your-value",
        "SPARKPLUG_HOST_ID": "your-value",
        "SPARKPLUG_MQTT_PORT": "your-value",
        "SPARKPLUG_MQTT_USERNAME": "your-value",
        "SPARKPLUG_MQTT_PASSWORD": "your-value",
        "SPARKPLUG_MQTT_USE_TLS": "your-value",
        "SPARKPLUG_GROUP_ID": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "servers": {
    "sparkplug-b": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "sparkplug-b-mcp-server"
      ],
      "env": {
        "SPARKPLUG_MQTT_HOST": "your-value",
        "SPARKPLUG_HOST_ID": "your-value",
        "SPARKPLUG_MQTT_PORT": "your-value",
        "SPARKPLUG_MQTT_USERNAME": "your-value",
        "SPARKPLUG_MQTT_PASSWORD": "your-value",
        "SPARKPLUG_MQTT_USE_TLS": "your-value",
        "SPARKPLUG_GROUP_ID": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Valores que debes completar

SPARKPLUG_MQTT_HOST obligatorio env
MQTT broker hostname or IP.
SPARKPLUG_HOST_ID obligatorio env
This connector's Sparkplug Host Application ID (used in the spBv1.0/STATE/{id} topic).
SPARKPLUG_MQTT_PORT env
MQTT broker port, default 1883
SPARKPLUG_MQTT_USERNAME env
Broker username, if required
SPARKPLUG_MQTT_PASSWORD secreto env
Broker password, if required
SPARKPLUG_MQTT_USE_TLS env
true/false, default false
SPARKPLUG_GROUP_ID env
Restrict discovery/watching to a single Sparkplug Group ID; omit to subscribe to every group

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 6 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub nagarjunr, dueña del repo
… Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Comparado con otros en Otrosi

Más estrellas que el 0% de los otros 32435 servidores de esta categoría
Publicado en el registro más recientemente que el 21% de los otros 32435 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 32435 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Sparkplug B?

Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: SPARKPLUG_MQTT_HOST, SPARKPLUG_HOST_ID, SPARKPLUG_MQTT_PASSWORD

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (0.1.0) llegó al registro hace 3 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Spec Driven Development, Remote Desktop Commander, Apify MCP Server

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Spec Driven Development

de formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Se ejecuta en tu computadora★ 440MITActualizado hace 14 meses

Instalar

Remote Desktop Commander

de desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Se ejecuta en la nube★ 211Actualizado ayer

Instalar

Apify MCP Server

de apify

Extract data from any website with thousands of scrapers, crawlers, and automations on Apify Store ⚡

Se ejecuta en la nubeActualizado hoy

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

Sparkplug B MCP Server

A Model Context Protocol (MCP) server for Sparkplug B — the Eclipse-standard MQTT topic/payload convention for industrial/SCADA data (birth/death certificates, sequenced metrics, protobuf payloads). Works against any MQTT broker that carries Sparkplug B traffic; only the open Sparkplug B specification is used, no vendor-specific extensions.

This server acts as a Sparkplug B Primary Host Application: it subscribes to the entire spBv1.0 namespace, discovers Edge Nodes and Devices from their NBIRTH/DBIRTH messages, tracks their live metrics, and can send them commands (NCMD/DCMD) — the same role a SCADA/historian host application plays in a real deployment.

Built with FastMCP and pysparkplug (itself built on paho-mqtt).

Tools

Tool	Description
`get_connection_status()`	Report the broker connection and this host application's identity.
`set_host_online(online)`	Publish this connector's own retained Sparkplug `STATE` message.
`list_edge_nodes(group_id?)`	List Edge Nodes discovered via `NBIRTH`/`NDEATH`.
`list_devices(group_id?, edge_node_id?)`	List Devices discovered via `DBIRTH`/`DDEATH`.
`get_node_metrics(group_id, edge_node_id)`	Latest known metric values for an Edge Node.
`get_device_metrics(group_id, edge_node_id, device_id)`	Latest known metric values for a Device.
`send_node_command(group_id, edge_node_id, metrics)`	Send an `NCMD` — write one or more of a node's metrics.
`send_device_command(group_id, edge_node_id, device_id, metrics)`	Send a `DCMD` — write one or more of a device's metrics.
`request_node_rebirth(group_id, edge_node_id)`	Standard `Node Control/Rebirth` command — asks a node to republish its full `NBIRTH`.
`start_watch(group_id?, edge_node_id?, device_id?, message_types?)`	Start buffering decoded Sparkplug traffic matching an optional filter. Returns a `session_id`.
`get_events(session_id, max_events, timeout_seconds)`	Drain buffered events from a watch session; can wait briefly for one to arrive.
`stop_watch(session_id)`	Stop a watch session and discard its buffered events.
`list_watches()`	List all active watch sessions.

Why watching is session-based

Like the MQTT wire protocol underneath it, Sparkplug B is a continuous stream, not a request/response API — a single MCP tool call can't "wait forever" for the next birth or data message. start_watch registers an optional filter (group/node/device/message-type) and buffers matching decoded messages in the background (this connector is always subscribed to the whole spBv1.0 namespace, so no extra broker subscription is needed per watch); get_events drains that buffer, optionally waiting a bounded amount of time for new data. Call stop_watch when done.

Supported metric datatypes

INT8/INT16/INT32/INT64, UINT8/UINT16/UINT32/UINT64, FLOAT, DOUBLE, BOOLEAN, STRING, TEXT, UUID, DATETIME, BYTES, FILE, and their *_ARRAY variants. DATASET, TEMPLATE, PROPERTYSET, and PROPERTYSETLIST are part of the Sparkplug B spec but unsupported by the underlying pysparkplug codec, so they're rejected with a clear error rather than silently mishandled.

For send_node_command/send_device_command, value shape depends on datatype: plain int/float/bool/str for scalars, an ISO 8601 string for DATETIME, a base64 string for BYTES/FILE, and a JSON list for *_ARRAY types.

Configuration

Env var	Required	Description
`SPARKPLUG_MQTT_HOST`	Yes	Broker hostname or IP.
`SPARKPLUG_HOST_ID`	Yes	This connector's Sparkplug Host Application ID (used in the `spBv1.0/STATE/{id}` topic).
`SPARKPLUG_MQTT_PORT`	No	Default `1883`.
`SPARKPLUG_MQTT_USERNAME` / `SPARKPLUG_MQTT_PASSWORD`	No	Broker credentials.
`SPARKPLUG_MQTT_CLIENT_ID`	No	Defaults to a broker-assigned ID.
`SPARKPLUG_MQTT_KEEPALIVE`	No	Seconds, default `60`.
`SPARKPLUG_MQTT_CONNECT_TIMEOUT`	No	Seconds to wait for the initial connect, default `10`.
`SPARKPLUG_MQTT_USE_TLS`	No	`true`/`false`, default `false`.
`SPARKPLUG_MQTT_TLS_CA_CERTS`	No	Path to a CA bundle. Omit to use the system trust store.
`SPARKPLUG_MQTT_TLS_CLIENT_CERT` / `SPARKPLUG_MQTT_TLS_CLIENT_KEY`	No	For mutual TLS.
`SPARKPLUG_GROUP_ID`	No	Restrict discovery/watching to a single Sparkplug Group ID. Omit to subscribe to every group (`spBv1.0/#`).

Running locally

uv sync

export SPARKPLUG_MQTT_HOST=localhost export SPARKPLUG_MQTT_PORT=1883 export SPARKPLUG_HOST_ID=my-mcp-host uv run sparkplugbmcpserver.py

See mcp.json for ready-to-use client configs (stdio and Docker).

Testing against a real broker

This repo's design principles call for testing against a real instance rather than mocks. docker-compose.yml spins up Eclipse Mosquitto (2.x) with an anonymous listener for local testing. Test fixtures use pysparkplug's own EdgeNode/Device classes to act as real simulated PLCs/devices — publishing genuine NBIRTH/DBIRTH/NDATA/DDATA/NDEATH messages and receiving genuine NCMD/DCMD commands over the wire — so coverage is protocol-level, not hand-rolled mocks. Only the "physical" node/device is simulated, since no free real PLC/edge-node hardware exists to test against; the Sparkplug B protocol handling on both sides is real.

docker compose up -d       # start Mosquitto on localhost:1883 (anonymous, local testing only)

uv run pytest -v # tests/conftest.py also starts/stops the stack automatically docker compose down # stop it manually if you started it yourself

License notes

docker-compose.yml and the files under docker/ configure the open-source Eclipse Mosquitto broker (EPL-2.0) for local testing only — they are not part of the MCP server itself.

Sparkplug B

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

Valores que debes completar

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Comparado con otros en Otrosi

Preguntas frecuentes

Alternativas

Spec Driven Development

Remote Desktop Commander

Apify MCP Server

README del creador

Sparkplug B MCP Server

Tools

Why watching is session-based

Supported metric datatypes

Configuration

Running locally

Testing against a real broker

License notes