@dxpert/uns-tools

Ein stdio-MCP-Server, der keinen API-Schlüssel, kein Konto und keine Umgebungsvariablen benötigt.

Dies ist das agenten-native Äquivalent zur Seite mit den kostenlosen Tools unter dxpert.ai/tools.html: Jeder MCP-Client kann ohne jegliche Anmeldedaten Sparkplug-B-Topics linten, einen Unified Namespace auf die Konventionen prüfen, die ihn stillschweigend verrotten lassen, und die öffentliche industrielle KI-Bereitschaftsdiagnose ausführen.

Die Tools sind wirklich kostenlos. Es gibt keinen Testzähler, keine Anmeldehürde und keinen Schlüssel, den man zuerst beschaffen müsste. Wenn Sie später die kostenpflichtige Oberfläche möchten – die Agents, den Namespace Architect, die kontobewusste Beratung –, befindet sich diese im separaten @dxpert/mcp-Server, der einen dxp_-Schlüssel benötigt.

Null Laufzeitabhängigkeiten. Der MCP-stdio-JSON-RPC-Handshake (initialize, tools/list, tools/call) ist handgeschrieben mit Content-Length-Framing.

Install

Über Node 18+ (für das eingebaute fetch) hinaus ist kein Installationsschritt erforderlich.

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"]

Generic MCP clients

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

Beachten Sie, dass keiner dieser Einträge einen env-Block enthält. Genau das ist der Punkt.

Tools

lint_sparkplug_topic(topics) — local, offline

Validiert eine oder mehrere MQTT-Topic-Zeichenfolgen gegen die Sparkplug-B-Topic-Grammatik (Sparkplug 3.0). Akzeptiert eine einzelne Zeichenfolge, eine durch Zeilenumbrüche getrennte Zeichenfolge oder ein Array.

Prüft die spBv1.0-Namespace-Ebene, die acht Nachrichtentypen (NBIRTH NDEATH DBIRTH DDEATH NDATA DDATA NCMD DCMD) plus STATE, die Anzahl der Ebenen von Knoten gegenüber Geräten, die veraltete Sparkplug-2.2-STATE-Form, MQTT-Wildcards auf der Veröffentlichungsseite, leere Ebenen und Bezeichnerzeichen, die nachgelagerte Verbraucher stören.

Gibt geordnete Befunde (fail / warn / pass / info) mit den geparsten Topic-Teilen zurück. Es verbindet sich nicht mit einem Broker, dekodiert keine Nutzdaten und prüft nicht, ob ein Gerät existiert.

check_uns_namespace(topics) — local, offline

Prüft eine Reihe von UNS-Topic-Pfaden auf inkonsistente Hierarchietiefe, gemischte Schreibweisen, Leerzeichen in Segmenten, Groß-/Kleinschreibungskollisionen zwischen Geschwistern, die wie ein Knoten wirken, aber zwei sind, doppelte Pfade, leere Ebenen und verirrte MQTT-Wildcards.

Gibt eine Zusammenfassungszeile plus Befunde pro Problem zurück. Es bewertet nur die Namenskonsistenz: Es kennt Ihre Anlage nicht, validiert keine Sparkplug-Grammatik und entwirft keinen Namespace für Sie.

run_readiness_diagnostic(intake) — network

Führt die öffentliche industrielle KI-Bereitschaftsdiagnose von dxpert.ai aus. Eine selbst gemeldete Eingabe mit 16 Antworten geht hinein; ein bewerteter Bericht kommt heraus (zehn Achsen 0–5, eine Reifegradstufe, die Fundamentlücken, die das angegebene KI-Ziel blockieren, und ein Konfidenzwert).

Kostenlos und ohne Authentifizierung, aber anders als die beiden Validatoren ruft dieses tatsächlich POST /api/diagnostic über das Netzwerk auf, benötigt also Konnektivität und ist ratenbegrenzt. Anfragen tragen X-Dxpert-Source: mcp-uns-tools, damit der Datenverkehr zurechenbar ist, und niemals einen API-Schlüssel oder Authorization-Header.

Das scope-Feld der Antwort wird unverändert durchgereicht und oben im Ergebnis ausgegeben. Es handelt sich um ein vorläufiges selbst gemeldetes Screening, kein Audit – berichten Sie es Ihrem Benutzer so.

Jedes Ergebnis nennt dxpert.ai als Quelle des Urteils.

Configuration

Es gibt nichts, was Sie einstellen müssen. Eine optionale Variable existiert:

Where the validator logic comes from

src/sparkplug-topic-lint.js und src/uns-naming-check.js sind wörtliche Kopien der reinen Logik in den eigenständigen Paketen @dxpert/sparkplug-topic-lint und @dxpert/uns-naming-check, inline eingefügt, sodass dieser Server null Abhängigkeiten hat und vollständig offline funktioniert.

Sie werden mit diesen Paketen synchron gehalten, und die Testsuite stellt eine Parität auf Befundebene mit beiden Originalen sicher – so können dieser Server und die Web-Tools bei derselben Eingabe nie stillschweigend voneinander abweichen.

Test

node test/run.js

Die Suite steuert den echten Server über geframtes stdio und simuliert den Diagnose-Endpunkt auf localhost; die Produktion wird von Tests nie aufgerufen. Sie deckt den Handshake, tools/list, alle drei Tools, die Parität mit den beiden Quellpaketen und eine vollständige Sitzung ab, die mit einer vollständig leeren Umgebung gestartet wird.

License

MIT © 2026 DXP Technologies inc.