@dxpert/uns-tools

Stdio MCP-сервер, которому не нужны ни API-ключ, ни аккаунт, ни переменные окружения.

Это агент-нативный аналог страницы бесплатных инструментов на dxpert.ai/tools.html: любой MCP-клиент без каких-либо учётных данных может проверить темы Sparkplug B, проверить Unified Namespace на предмет соглашений, которые незаметно разрушают его, и запустить публичную диагностику промышленной ИИ-готовности.

Инструменты действительно бесплатны. Нет счётчика пробных версий, нет регистрации и нет необходимости сначала получать ключ. Если позже вы захотите платную поверхность — агентов, Namespace Architect, консультации с учётом аккаунта — она находится в отдельном сервере @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) — локально, офлайн

Проверяет одну или несколько строк тем MQTT на соответствие грамматике тем Sparkplug B (Sparkplug 3.0). Принимает одну строку, строку, разделённую переводами строк, или массив.

Проверяет уровень пространства имён spBv1.0, восемь типов сообщений (NBIRTH NDEATH DBIRTH DDEATH NDATA DDATA NCMD DCMD) плюс STATE, количество уровней для узла и устройства, устаревшую форму STATE из Sparkplug 2.2, подстановочные знаки MQTT на стороне публикации, пустые уровни и символы идентификаторов, которые ломают нижестоящих потребителей.

Возвращает упорядоченные результаты (fail / warn / pass / info) с разобранными частями темы. Он не подключается к брокеру, не декодирует полезные нагрузки и не проверяет существование устройства.

check_uns_namespace(topics) — локально, офлайн

Проверяет набор путей тем UNS на предмет несогласованной глубины иерархии, смешанных стилей регистра, пробелов в сегментах, коллизий регистра между соседними узлами, которые выглядят как один узел, но являются двумя, дублирующихся путей, пустых уровней и случайных подстановочных знаков MQTT.

Возвращает сводную строку и результаты по каждой проблеме. Он оценивает только согласованность именования: он не знает ваше предприятие, не проверяет грамматику Sparkplug и не проектирует пространство имён за вас.

run_readiness_diagnostic(intake) — сеть

Запускает публичную диагностику промышленной ИИ-готовности dxpert.ai. На вход подаётся самоотчёт из 16 ответов; на выходе — отчёт с оценками (десять осей от 0 до 5, стадия зрелости, пробелы в фундаменте, блокирующие заявленную ИИ-амбицию, и значение уверенности).

Бесплатный и без аутентификации, но, в отличие от двух валидаторов, этот действительно вызывает 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, встроенными в этот сервер, чтобы он имел ноль зависимостей и работал полностью офлайн.

Они синхронизируются с этими пакетами, и набор тестов проверяет паритет на уровне результатов с обоими оригиналами — так что этот сервер и веб-инструменты никогда не смогут незаметно разойтись во мнениях об одном и том же входе.

Тест

node test/run.js

Набор тестов запускает реальный сервер через кадрированный stdio и имитирует конечную точку диагностики на localhost; продакшн никогда не вызывается из тестов. Он покрывает рукопожатие, tools/list, все три инструмента, паритет с двумя исходными пакетами и полный сеанс, запущенный с полностью пустым окружением.

Лицензия

MIT © 2026 DXP Technologies inc.