dxpert UNS tools

@dxpert/uns-tools

API キー、アカウント、環境変数が一切不要な stdio MCP サーバーです。

これは、dxpert.ai/tools.html にある無料ツールページをエージェント向けにしたものです。認証情報がなくても、どの MCP クライアントからでも Sparkplug B トピックを lint し、Unified Namespace をひそかに劣化させる慣習がないか確認し、公開されている産業用 AI 対応度診断を実行できます。

ツールは本当に無料です。試用回数の制限も、登録の壁も、事前に取得するキーもありません。エージェントに自分のデータを読み取らせたい場合は、別の @dxpert/mcp サーバーを利用します。このサーバーには dxp_ キーが必要です。無料キーには dxpert Advisor（月ごとの質問枠）と Try Pro（dxpert Pro に含まれる任意のエージェントを 5 回実行）が含まれます。dxpert Pro には、すべての UNS エージェント、月ごとの回数制限がない dxpert Advisor、そして公開時に Namespace Architect が含まれます。現在のプランは dxpert.ai/store をご覧ください。

実行時の依存関係はゼロです。MCP stdio JSON-RPC ハンドシェイク（initialize、tools/list、tools/call）は、標準の改行区切り JSON（Content-Length フレーミングにも対応）を使用して手動で実装されています。

インストール

Node 18+（組み込みの fetch を利用するため）以外にインストール手順は不要です。

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

汎用 MCP クライアント

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

これらの設定には、いずれも env ブロックが含まれていないことにご注意ください。それが重要な点です。

ツール

lint_sparkplug_topic(topics) — ローカル、オフライン

1 つ以上の MQTT トピック文字列が Sparkplug B トピック文法（Sparkplug 3.0）に準拠しているか検証します。単一の文字列、改行区切りの文字列、または配列を受け付けます。

spBv1.0 名前空間レベル、8 種類のメッセージタイプ（NBIRTH NDEATH DBIRTH DDEATH NDATA DDATA NCMD DCMD）と STATE、ノードレベルとデバイスレベルの数、従来の Sparkplug 2.2 の STATE 形式、パブリッシュ側の MQTT ワイルドカード、空のレベル、下流のコンシューマーに問題を起こす識別子文字を確認します。

解析済みのトピック部分とともに、順序付けされた検出結果（fail / warn / pass / info）を返します。ブローカーへの接続、ペイロードのデコード、デバイスの存在確認は行いません。

check_uns_namespace(topics) — ローカル、オフライン

一連の UNS トピックパスについて、階層の深さの不一致、大文字・小文字のスタイルの混在、セグメント内の空白、1 つのノードのように見えて実際には別の 2 つのノードである兄弟間の大文字・小文字の衝突、重複パス、空のレベル、不要な MQTT ワイルドカードがないか確認します。

概要の行と問題ごとの検出結果を返します。名前の一貫性のみを判定します。プラントについての情報は持たず、Sparkplug の文法を検証せず、名前空間の設計も行いません。

run_readiness_diagnostic(intake) — ネットワーク

公開されている dxpert.ai の産業用 AI 対応度診断を実行します。16 項目の自己申告による回答を入力すると、スコア付きレポートが返されます（10 軸の 0～5 のスコア、成熟度ステージ、申告された AI 活用目標を妨げる基盤の不足点、信頼度）。

無料で認証も不要ですが、2 つのバリデーターとは異なり、これはネットワーク経由で POST /api/diagnostic を実行するため、接続が必要で、レート制限もあります。リクエストには、トラフィックを識別できるよう X-Dxpert-Source: mcp-uns-tools が付加されます。API キーや Authorization ヘッダーが送信されることはありません。

レスポンスの scope フィールドはそのまま渡され、結果の先頭に表示されます。これは監査ではなく、自己申告に基づく予備的なスクリーニングです。ユーザーにはそのように伝えてください。

すべての結果で、判定の情報源として dxpert.ai が明記されます。

設定

設定が必要な項目はありません。任意の変数が 1 つあります。

変数	必須	用途
DXPERT_API_BASE	いいえ	run_readiness_diagnostic の API ベース URL。既定値は本番環境です。テスト時のみ上書きしてください。

バリデーターのロジックの由来

src/sparkplug-topic-lint.js と src/uns-naming-check.js は、スタンドアロンパッケージ @dxpert/sparkplug-topic-lint および @dxpert/uns-naming-check に含まれる純粋なロジックをそのままコピーしたものです。このサーバーが依存関係ゼロで完全にオフラインで動作できるよう、コードに直接組み込んでいます。

これらはパッケージと同期が保たれており、テストスイートでは両方のオリジナルに対して検出結果の同等性を検証します。そのため、このサーバーとウェブツールが同じ入力に対して気付かないうちに異なる結果を返すことはありません。

テスト

node test/run.js

テストスイートでは、フレーム化された標準入出力を介して実際のサーバーを実行し、ローカルホスト上の診断エンドポイントをモックします。本番環境にテストからアクセスすることはありません。ハンドシェイク、tools/list、3つすべてのツール、2つのソースパッケージとの同等性、そして環境変数が完全に空の状態で開始する完全なセッションをテストします。

ライセンス

MIT © 2026 DXP Technologies inc.