@dxpert/uns-tools

一个无需 API 密钥、无需账户、无需环境变量的 stdio MCP 服务器。

这是 dxpert.ai/tools.html 免费工具页面的代理原生等价物：任何 MCP 客户端，在零凭据的情况下，都可以对 Sparkplug B 主题进行 lint 检查，检查统一命名空间（Unified Namespace）中悄然腐化的约定，并运行公开的工业 AI 就绪度诊断。

这些工具是真正免费的。没有试用计数器，没有注册门槛，也不需要先获取密钥。如果你之后想要付费功能——代理、命名空间架构师、账户感知咨询——这些位于独立的 @dxpert/mcp 服务器中，该服务器确实需要 dxp_ 密钥。

零运行时依赖。MCP stdio JSON-RPC 握手（initialize、tools/list、tools/call）是使用 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 命名为裁决的来源。

配置

你无需设置任何内容。存在一个可选变量：

验证器逻辑的来源

src/sparkplug-topic-lint.js 和 src/uns-naming-check.js 是独立包 @dxpert/sparkplug-topic-lint 和 @dxpert/uns-naming-check 中纯逻辑的逐字副本，内联后使此服务器具有零依赖并完全离线工作。

它们与这些包保持同步，测试套件断言与两个原始包的发现级别一致性——因此此服务器和 Web 工具永远不会对同一输入悄悄产生分歧。

测试

node test/run.js

该套件通过带帧的 stdio 驱动真实服务器，并在 localhost 上模拟诊断端点；测试中从不调用生产环境。它涵盖握手、tools/list、所有三个工具、与两个源包的奇偶校验，以及以完全空的环境启动的完整会话。

许可证

MIT © 2026 DXP Technologies inc.