@theyahia/chestnyznak-mcp

Servidor MCP para la API «Честный ЗНАК» / ЦРПТ — verificación del marcado de productos. 5 herramientas. Verificaciones públicas sin autorización, información de True API con token.

Parte de la serie Russian API MCP (50 servidores) por @theYahia.

Instalación

Claude Desktop

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

Claude Desktop (con autorización)

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

Por defecto, el servidor HTTP escucha solo en 127.0.0.1 y verifica la cabecera Host (protección contra DNS-rebinding). Para exponerlo al exterior, use --host=0.0.0.0 (bajo su propio riesgo; no hay autenticación en /mcp).

Related MCP server: nip-checker-mcp

Variables de entorno

Herramientas (5)

Públicas (sin autorización)

codeType — datamatrix (por defecto), qr o ean13.

Autorizadas (CHESTNYZNAK_TOKEN)

La búsqueda por nombre/marca es el Catálogo Nacional (nk.crpt.ru), una API separada; no se admite aquí. search_products funciona por GTIN.

Formato de respuesta

check_marking_code:

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

get_product_info (los campos producer/owner/status se toman del objeto anidado del grupo de productos; si no existen, null):

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

status — un enum de cadena: EMITTED / APPLIED / INTRODUCED / RETIRED / WRITTEN_OFF / DISAGGREGATION, etc.

Cada herramienta devuelve además structuredContent (un objeto tipado según outputSchema), además del JSON de texto.

Ejemplos

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

Autorización (True API)

⚠️ Importante: True API (GIS MT) no tiene un token estático «eterno». El token se obtiene mediante el esquema «solicitud-firma» con un certificado УКЭП (GOST):

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

2. Firmar data con un certificado УКЭП (CAdES-BES, base64).

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

4. La vigencia del token es de no más de ~10 horas; luego se requiere autorización de nuevo.

Este servidor utiliza CHESTNYZNAK_TOKEN como un token ya obtenido de esta forma (se envía como Authorization: Bearer). La firma УКЭП se realiza fuera del servidor (por ejemplo, mediante CryptoPro); aquí no hay firma GOST incorporada. El registro está disponible para personas jurídicas/empresarios individuales en markirovka.crpt.ru.

Los endpoints/métodos de la parte autorizada (rutas, cuerpo de la solicitud) se han contrastado con la documentación oficial y clientes abiertos, pero no se han probado contra un token real debido al requisito de УКЭП. Si ЦРПТ cambia el contrato, corríjalo mediante CHESTNYZNAK_BASE_URL.

Skills

Solución de problemas

API

• Pública (sin autorización): GET https://mobile.api.crpt.ru/mobile/check?code=<код>&codeType=<тип> — endpoint no documentado de la aplicación móvil.

• Autorizada (Bearer): https://markirovka.crpt.ru/api/v3/true-api/... — True API (GIS MT).

Desarrollo

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)

Licencia

MIT