@dxpert/uns-tools

API 키, 계정, 환경 변수가 전혀 필요 없는 stdio MCP 서버입니다.

이것은 dxpert.ai/tools.html의 무료 도구 페이지에 해당하는 에이전트 네이티브 버전입니다. 자격 증명 없이도 모든 MCP 클라이언트가 Sparkplug B 토픽을 린트하고, Unified Namespace에서 조용히 부패시키는 규칙 위반을 확인하며, 공개 산업용 AI 준비도 진단을 실행할 수 있습니다.

도구는 진정으로 무료입니다. 평가판 횟수 제한도, 가입 장벽도, 먼저 발급받아야 할 키도 없습니다. 나중에 유료 기능(에이전트, 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 네임스페이스 레벨, 8가지 메시지 유형(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개 답변의 자가 보고 인테이크가 입력되면, 점수 보고서가 출력됩니다(10개 축 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의 순수 로직을 그대로 복사한 것으로, 이 서버가 의존성 없이 완전히 오프라인으로 작동하도록 인라인되었습니다.

이 파일들은 해당 패키지들과 동기화되어 유지되며, 테스트 스위트는 두 원본 모두에 대해 결과 수준의 동등성을 검증합니다. 따라서 이 서버와 웹 도구는 동일한 입력에 대해 조용히 의견이 갈라질 수 없습니다.

테스트

node test/run.js

테스트 스위트는 프레이밍된 stdio를 통해 실제 서버를 구동하고 진단 엔드포인트를 localhost에서 모의(mock)합니다. 프로덕션은 테스트에서 절대 호출되지 않습니다. 핸드셰이크, tools/list, 세 가지 도구 모두, 두 소스 패키지와의 동등성, 그리고 완전히 빈 환경에서 시작된 전체 세션을 다룹니다.

라이선스

MIT © 2026 DXP Technologies inc.