@theyahia/chestnyznak-mcp

«Честный ЗНАК» / ЦРПТ API용 MCP 서버 — 제품 마킹 확인. 도구 5개. 인증 없이 공개 확인, 토큰을 사용한 True API 정보.

시리즈 Russian API MCP (50개 서버)의 일부, @theYahia 제작.

설치

Claude Desktop

{
  "mcpServers": {
    "chestnyznak": {
      "command": "npx",
      "args": ["-y", "@theyahia/chestnyznak-mcp"]
    }
  }
}

Claude Desktop (인증 포함)

{
  "mcpServers": {
    "chestnyznak": {
      "command": "npx",
      "args": ["-y", "@theyahia/chestnyznak-mcp"],
      "env": {
        "CHESTNYZNAK_TOKEN": "ваш-токен"
      }
    }
  }
}

Claude Code

claude mcp add chestnyznak -- npx -y @theyahia/chestnyznak-mcp

# С авторизацией
CHESTNYZNAK_TOKEN=ваш-токен claude mcp add chestnyznak -- npx -y @theyahia/chestnyznak-mcp

Streamable HTTP

npx @theyahia/chestnyznak-mcp --http --port=3000
# Endpoint: POST http://127.0.0.1:3000/mcp
# Health:   GET  http://127.0.0.1:3000/health

기본적으로 HTTP 서버는 127.0.0.1만 수신하며 Host 헤더를 확인합니다(DNS 리바인딩 방지). 외부에 열려면 --host=0.0.0.0(자체 위험 부담, /mcp에는 인증이 없음).

Related MCP server: nip-checker-mcp

환경 변수

도구 (5)

공개 (인증 없음)

codeType — datamatrix(기본값), qr 또는 ean13.

인증됨 (CHESTNYZNAK_TOKEN)

이름/브랜드 검색은 별도 API인 국가 카탈로그(nk.crpt.ru)이며 여기서는 지원되지 않습니다. search_products는 GTIN으로 작동합니다.

응답 형식

check_marking_code:

{ "code": "0104600702028445", "found": true, "valid": true, "status": "INTRODUCED" }

get_product_info(producer/owner/status 필드는 제품 그룹의 중첩 객체에서 가져오며, 없으면 null입니다):

{
  "code": "0104600702028445",
  "found": true,
  "valid": true,
  "status": "INTRODUCED",
  "productName": "Молоко 3.2%",
  "category": "milk",
  "producerName": "АО \"Данон Россия\"",
  "ownerName": "ООО Магнит",
  "ownerInn": "2309085638"
}

status — 문자열 enum: EMITTED / APPLIED / INTRODUCED / RETIRED / WRITTEN_OFF / DISAGGREGATION 등.

각 도구는 텍스트 JSON 외에도 structuredContent(outputSchema에 따른 타입 객체)를 추가로 반환합니다.

예시

Проверь код маркировки 0104600702028445
Расскажи подробнее о товаре с кодом 010460070202844521
Проверь пачку кодов: 0104600702028445, 0104600702028446
Информация о товаре с GTIN 04600702028445
Информация о CIS 0104600702028445

인증 (True API)

⚠️ 중요: True API(ГИС МТ)에는 정적 '영구' 토큰이 없습니다. 토큰은 УКЭП(ГОСТ) 인증서로 '요청-서명' 방식으로 얻습니다:

1. GET /api/v3/true-api/auth/key → { uuid, data }

2. data를 УКЭП(CAdES-BES, base64) 인증서로 서명합니다.

3. POST /api/v3/true-api/auth/simpleSignIn { uuid, data: <подпись> } → 토큰.

4. 토큰 수명은 ~10시간을 넘지 않으며, 이후 다시 인증해야 합니다.

이 서버는 CHESTNYZNAK_TOKEN을 이렇게 이미 획득한 토큰으로 사용합니다(Authorization: Bearer로 전송됨). УКЭП 서명은 서버 외부(예: КриптоПро)에서 수행되며, 내장된 GOST 서명 기능은 없습니다. 등록은 markirovka.crpt.ru에서 법인/개인사업자에게 가능합니다.

인증 부분의 엔드포인트/메서드(경로, 요청 본문)는 공식 문서와 공개 클라이언트를 기준으로 검증했지만, УКЭП 요구 사항으로 인해 실제 토큰으로는 테스트되지 않았습니다. ЦРПТ가 계약을 변경하면 CHESTNYZNAK_BASE_URL로 수정하세요.

스킬

문제 해결

API

• 공개(인증 없음): GET https://mobile.api.crpt.ru/mobile/check?code=<код>&codeType=<тип> — 모바일 앱의 비공식 엔드포인트.

• 인증됨(Bearer): https://markirovka.crpt.ru/api/v3/true-api/... — True API(ГИС МТ).

개발

npm ci
npm run typecheck   # tsc --noEmit (src + tests)
npm test            # vitest
npm run build       # tsc -> dist/
npm run dev         # tsx watch (stdio)
npm run dev:http    # tsx watch (HTTP)

라이선스

MIT