@dxpert/uns-tools

Un servidor MCP stdio que no necesita clave API, ni cuenta, ni variables de entorno.

Es el equivalente nativo para agentes de la página de herramientas gratuitas en dxpert.ai/tools.html: cualquier cliente MCP, sin credenciales, puede validar temas Sparkplug B, comprobar un Unified Namespace en busca de las convenciones que lo degradan silenciosamente, y ejecutar el diagnóstico público de preparación para IA industrial.

Las herramientas son realmente gratuitas. No hay contador de prueba, ni muro de registro, ni clave que obtener primero. Si más adelante quieres la superficie de pago — los agentes, el Namespace Architect, el asesoramiento consciente de la cuenta — eso vive en el servidor separado @dxpert/mcp, que sí requiere una clave dxp_.

Cero dependencias en tiempo de ejecución. El protocolo de enlace MCP stdio JSON-RPC (initialize, tools/list, tools/call) está implementado a mano con delimitación Content-Length.

Instalación

No se requiere ningún paso de instalación más allá de Node 18+ (para fetch integrado).

Claude Code

claude mcp add dxpert-uns-tools -- npx -y @dxpert/uns-tools

Codex

[mcp_servers.dxpert_uns_tools]
command = "npx"
args = ["-y", "@dxpert/uns-tools"]

Clientes MCP genéricos

{
  "mcpServers": {
    "dxpert-uns-tools": {
      "command": "npx",
      "args": ["-y", "@dxpert/uns-tools"]
    }
  }
}

Ten en cuenta que ninguna de estas entradas lleva un bloque env. Ese es el punto.

Herramientas

lint_sparkplug_topic(topics) — local, sin conexión

Valida una o más cadenas de tema MQTT contra la gramática de temas Sparkplug B (Sparkplug 3.0). Acepta una sola cadena, una cadena delimitada por saltos de línea o un array.

Comprueba el nivel de espacio de nombres spBv1.0, los ocho tipos de mensaje (NBIRTH NDEATH DBIRTH DDEATH NDATA DDATA NCMD DCMD) más STATE, el recuento de niveles nodo vs. dispositivo, la forma heredada STATE de Sparkplug 2.2, los comodines MQTT del lado de publicación, los niveles vacíos y los caracteres de identificador que rompen a los consumidores posteriores.

Devuelve hallazgos ordenados (fail / warn / pass / info) con las partes del tema analizadas. No se conecta a un broker, no decodifica cargas útiles ni verifica que un dispositivo exista.

check_uns_namespace(topics) — local, sin conexión

Comprueba un conjunto de rutas de temas UNS en busca de profundidad de jerarquía inconsistente, estilos de mayúsculas mezclados, espacios en blanco en segmentos, colisiones de mayúsculas entre hermanos que se leen como un solo nodo pero son dos, rutas duplicadas, niveles vacíos y comodines MQTT sueltos.

Devuelve una línea de resumen más hallazgos por problema. Solo juzga la consistencia de nombres: no conoce tu planta, no valida la gramática Sparkplug y no diseña un espacio de nombres por ti.

run_readiness_diagnostic(intake) — red

Ejecuta el diagnóstico público de preparación para IA industrial de dxpert.ai. Se introduce una autoevaluación de 16 respuestas; sale un informe puntuado (diez ejes de 0 a 5, una etapa de madurez, las brechas de fundamento que bloquean la ambición de IA declarada y un valor de confianza).

Gratuito y sin autenticación, pero a diferencia de los dos validadores, este sí llama a POST /api/diagnostic a través de la red, por lo que necesita conectividad y está limitado en velocidad. Las solicitudes llevan X-Dxpert-Source: mcp-uns-tools para que el tráfico sea atribuible, y nunca una clave API ni un encabezado Authorization.

El campo scope de la respuesta se transmite textualmente y se imprime al principio del resultado. Es un cribado preliminar autodeclarado, no una auditoría — comunícalo así a tu usuario.

Cada resultado nombra a dxpert.ai como fuente del veredicto.

Configuración

No hay nada que tengas que configurar. Existe una variable opcional:

De dónde proviene la lógica de los validadores

src/sparkplug-topic-lint.js y src/uns-naming-check.js son copias textuales de la lógica pura de los paquetes independientes @dxpert/sparkplug-topic-lint y @dxpert/uns-naming-check, integrados para que este servidor tenga cero dependencias y funcione completamente sin conexión.

Se mantienen sincronizados con esos paquetes, y la suite de pruebas afirma paridad a nivel de hallazgos contra ambos originales — de modo que este servidor y las herramientas web nunca pueden discrepar silenciosamente sobre la misma entrada.

Pruebas

node test/run.js

La suite ejecuta el servidor real sobre stdio con delimitación y simula el endpoint de diagnóstico en localhost; la producción nunca se llama desde las pruebas. Cubre el protocolo de enlace, tools/list, las tres herramientas, la paridad con los dos paquetes fuente y una sesión completa iniciada con un entorno completamente vacío.

Licencia

MIT © 2026 DXP Technologies inc.