dxpert UNS tools

@dxpert/uns-tools

无需 API 密钥、账号或环境变量的 stdio MCP 服务。

这是 dxpert.ai/tools.html 免费工具页面的 Agent 原生版本：任何 MCP 客户端都无需任何凭据，即可检查 Sparkplug B 主题、核查 Unified Namespace 是否存在会悄然导致其退化的约定问题，并运行公开的工业 AI 就绪度诊断。

这些工具完全免费。没有试用次数限制、注册门槛，也无需预先获取密钥。当你想让 Agent 读取自己的数据时，可以使用单独的 @dxpert/mcp 服务，它需要 dxp_ 密钥。免费密钥包含 dxpert Advisor（每月问题额度）和 Try Pro：可在 dxpert Pro 中包含的任意 Agent 上运行 5 次。dxpert Pro 包含所有 UNS Agent、不限月度次数的 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) — 本地、离线

根据 Sparkplug B 主题语法（Sparkplug 3.0）验证一个或多个 MQTT 主题字符串。接受单个字符串、以换行符分隔的字符串或数组。

检查 spBv1.0 命名空间层级、八种消息类型（NBIRTH NDEATH DBIRTH DDEATH NDATA DDATA NCMD DCMD）以及 STATE、节点与设备层级数量、旧版 Sparkplug 2.2 STATE 格式、发布端 MQTT 通配符、空层级，以及会导致下游使用方出错的标识符字符。

返回按顺序排列的检查结果（fail / warn / pass / info），并附上已解析的主题部分。它不会连接到代理、解码负载或验证设备是否存在。

check_uns_namespace(topics) — 本地、离线

检查一组 UNS 主题路径是否存在层级深度不一致、大小写风格混用、片段中含空格、兄弟节点大小写冲突（看起来是同一个节点，实际却是两个）、重复路径、空层级和多余的 MQTT 通配符。

返回摘要行和逐项问题检查结果。它只评估命名一致性：不了解你的工厂，不验证 Sparkplug 语法，也不会替你设计命名空间。

run_readiness_diagnostic(intake) — 网络

运行公开的 dxpert.ai 工业 AI 就绪度诊断。输入 16 项自我报告问卷，输出评分报告（十个维度各为 0–5 分、一个成熟度阶段、阻碍既定 AI 目标的基础差距，以及一个置信度值）。

免费且无需身份验证，但与两个验证工具不同，它确实会通过网络调用 POST /api/diagnostic，因此需要网络连接，并受速率限制。请求会携带 X-Dxpert-Source: mcp-uns-tools，以便追踪流量来源；绝不会携带 API 密钥或 Authorization 标头。

响应中的 scope 字段会原样传递，并显示在结果顶部。这是一项基于自我报告的初步筛查，而非审计——请向用户如实说明。

每项结果都会将 dxpert.ai 列为判定来源。

配置

无需设置任何内容。这里有一个可选变量：

变量	必需	用途
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 中纯逻辑的原样副本，内嵌于此，让此服务不依赖任何依赖项，并可完全离线运行。

我们会让它们与这些软件包保持同步，测试套件也会对照两个原始软件包检查结果级别的一致性——因此，此服务和 Web 工具绝不会对同一输入悄然给出不同结果。

测试

node test/run.js

测试套件通过带帧的标准输入／输出驱动真实服务，并在 localhost 上模拟诊断端点；测试不会调用生产环境。测试覆盖握手、tools/list、全部三个工具、与两个源软件包的一致性，以及在环境完全为空的情况下启动的完整会话。

许可证

MIT © 2026 DXP Technologies inc.