@theyahia/chestnyznak-mcp

MCP-Server für die API „Честный ЗНАК“ / ЦРПТ – Prüfung der Produktkennzeichnung. 5 Tools. Öffentliche Prüfungen ohne Autorisierung, Informationen aus der True API mit Token.

Teil der Serie Russian API MCP (50 Server) von @theYahia.

Installation

Claude Desktop

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

Claude Desktop (mit Autorisierung)

{
  "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

Standardmäßig lauscht der HTTP-Server nur auf 127.0.0.1 und prüft den Host-Header (Schutz vor DNS-Rebinding). Um ihn nach außen zu öffnen – --host=0.0.0.0 (auf eigene Gefahr, auf /mcp gibt es keine Authentifizierung).

Related MCP server: nip-checker-mcp

Umgebungsvariablen

Tools (5)

Öffentlich (ohne Autorisierung)

codeType – datamatrix (Standard), qr oder ean13.

Autorisiert (CHESTNYZNAK_TOKEN)

Die Suche nach Name/Marke erfolgt über den Nationalen Katalog (nk.crpt.ru), eine separate API; sie wird hier nicht unterstützt. search_products funktioniert über GTIN.

Antwortformat

check_marking_code:

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

get_product_info (die Felder producer/owner/status stammen aus dem verschachtelten Objekt der Produktgruppe, sonst null):

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

status – String-Enum: EMITTED / APPLIED / INTRODUCED / RETIRED / WRITTEN_OFF / DISAGGREGATION usw.

Jedes Tool gibt zusätzlich zum textuellen JSON structuredContent zurück (ein gemäß outputSchema typisiertes Objekt).

Beispiele

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

Autorisierung (True API)

⚠️ Wichtig: Die True API (ГИС МТ) hat keinen statischen „ewigen“ Token. Der Token wird nach dem Schema „Anfrage-Signatur“ mit einem УКЭП-Zertifikat (GOST) bezogen:

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

2. data mit einem УКЭП-Zertifikat (CAdES-BES, base64) signieren.

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

4. Die Lebensdauer des Tokens beträgt höchstens ~10 Stunden, danach ist eine erneute Autorisierung erforderlich.

Dieser Server verwendet CHESTNYZNAK_TOKEN als einen auf diesem Weg bereits erhaltenen Token (er wird als Authorization: Bearer gesendet). Die Signatur mit dem УКЭП-Zertifikat erfolgt außerhalb des Servers (z. B. über КриптоПро) – eine integrierte GOST-Signierung gibt es hier nicht. Die Registrierung steht juristischen Personen/Einzelunternehmern auf markirovka.crpt.ru offen.

Die Endpunkte/Methoden des autorisierten Teils (Pfade, Anfragetext) wurden anhand der offiziellen Dokumentation und offener Clients abgeglichen, aber nicht gegen einen echten Token getestet aufgrund der УКЭП-Anforderung. Sollte ЦРПТ den Vertrag ändern – korrigieren Sie dies über CHESTNYZNAK_BASE_URL.

Skills

Troubleshooting

API

• Öffentlich (ohne Autorisierung): GET https://mobile.api.crpt.ru/mobile/check?code=<код>&codeType=<тип> – undokumentierter Endpunkt der Mobil-App.

• Autorisiert (Bearer): https://markirovka.crpt.ru/api/v3/true-api/... – True API (ГИС МТ).

Entwicklung

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)

Lizenz

MIT