Chestnyznak Mcp

io.github.theYahia由 GitHub 帳號 theYahia 發布v1.0.0更新於 Nov 3, 2026

MCP server for Chestniy ZNAK (Честный ЗНАК) API — product marking verification. No auth needed for

已驗證STDIO僅桌面網頁搜尋與抓取商業與電商

概覽

AI 產生的概覽

針對俄羅斯 Chestny ZNAK（Честный ЗНАК）商品標記系統的 MCP 伺服器，讓助理查詢 DataMatrix、QR 或 EAN-13 編碼與商品資訊。

可以做什麼
  • 驗證標記碼的真偽與狀態，並取得商品名稱、類別、製造商與擁有者等詳細資料
  • 一次批次驗證最多 50 個編碼，並行數受限
  • 提供權杖時，可透過授權的 True API 依 GTIN 查詢商品資訊、查詢識別碼（CIS）資訊
  • 每個工具除文字 JSON 外，另回傳具型別的結構化內容
適用情境
適合在對話中核對俄羅斯商品標記碼、查看標記狀態與擁有者，而不必登入 Chestny ZNAK 網頁後台。公開驗證無需註冊即可使用；True API 查詢則需要自行取得的權杖。
執行需求
透過 npx 在本機執行（需要 Node.js）。公開工具無需憑證。search_products 與 get_cis_info 需要 CHESTNYZNAK_TOKEN 中的 True API 權杖，該權杖須在伺服器之外以 УКЭП 憑證簽章取得。可選用 CHESTNYZNAK_BASE_URL 與 CHESTNYZNAK_PUBLIC_BASE_URL 覆寫位址。需能連線 crpt.ru；公開 API 在非俄羅斯 IP 下可能沒有回應。
安裝前請注意
CHESTNYZNAK_TOKEN 中的權杖是 Bearer 憑證，效期約 10 小時，且須在本伺服器之外以 УКЭП 憑證簽章取得。授權端點雖依文件實作，但據說明尚未以真實權杖驗證。公開驗證使用未公開的行動應用程式端點。可選的 HTTP 模式對 /mcp 沒有身分驗證，對外開放須自行承擔風險。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Chestnyznak Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

MCP-сервер для Честного Знака — проверка маркировки товаров через ИИ

Если вы искали, как проверить код маркировки Честного Знака не заходя в личный кабинет, подключить True API ЦРПТ к нейросети или узнать статус товара прямо в чате — это оно. 5 инструментов: публичные проверки кодов работают сразу, без регистрации и токена; данные True API — по токену. Присылаете код DataMatrix — получаете статус, владельца и историю вместо вкладки с формой.

[npm] [License: MIT]

Часть серии WWmcp (46 серверов) by @theYahia.

Установка

Claude Desktop

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

Claude Desktop (с авторизацией)

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

Claude Code

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

Streamable HTTP

bash
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-rebinding). Чтобы открыть наружу — --host=0.0.0.0 (на свой риск, аутентификации на /mcp нет).

Переменные окружения

ПеременнаяОбязательнаОписание
CHESTNYZNAK_TOKENНетТокен True API для инструментов search_products, get_cis_info. См. «Авторизация».
CHESTNYZNAK_BASE_URLНетOrigin авторизованного API (по умолчанию https://markirovka.crpt.ru). Допускаются только https хосты *.crpt.ru / *.crptech.ru.
CHESTNYZNAK_PUBLIC_BASE_URLНетБазовый URL публичного API (по умолчанию https://mobile.api.crpt.ru/mobile). Удобно для моков в тестах.

Инструменты (5)

Публичные (без авторизации)

ИнструментАргументыОписание
check_marking_codecode, codeType?Проверка подлинности по коду маркировки
get_product_infocode, codeType?Подробная информация: название, группа, производитель, владелец
check_batchcodes[], codeType?Пакетная проверка до 50 кодов (параллелизм ограничен)

codeType — datamatrix (по умолчанию), qr или ean13.

Авторизованные (CHESTNYZNAK_TOKEN)

ИнструментАргументыОписание
search_productsquery (GTIN)Информация о товаре по GTIN из True API
get_cis_infocisИнформация о CIS (коде идентификации) из True API

Поиск по названию/бренду — это Национальный каталог (nk.crpt.ru), отдельный API; здесь не поддерживается. search_products работает по GTIN.

Формат ответа

check_marking_code:

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

get_product_info (поля producer/owner/status берутся из вложенного объекта группы товара, при отсутствии — null):

json
{  "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 и др.

Каждый инструмент дополнительно возвращает structuredContent (типизированный объект по outputSchema), помимо текстового JSON.

Примеры

Проверь код маркировки 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). Подпись УКЭП выполняется вне сервера (например, через КриптоПро) — встроенного ГОСТ-подписания здесь нет. Регистрация доступна юрлицам/ИП на markirovka.crpt.ru.

Эндпоинты/методы авторизованной части (пути, тело запроса) выверены по официальной документации и открытым клиентам, но не проверены против живого токена из-за требования УКЭП. Если ЦРПТ изменит контракт — поправьте через CHESTNYZNAK_BASE_URL.

Skills

SkillТриггер
skill-check-product«Проверь маркировку товара по коду»
skill-search«Найди товар по GTIN»

Troubleshooting

СимптомПричина / решение
CHESTNYZNAK_TOKEN не заданИнструменты search_products/get_cis_info требуют токен (см. «Авторизация»).
таймаут запроса / все попытки исчерпаныСеть/недоступность API; сервер делает до 3 попыток с backoff. Публичный API может не отвечать с не-РФ IP.
HTTP 401 / HTTP 403Токен невалиден или истёк (~10ч) — получите заново.
HTTP 429Рейт-лимит; сервер повторяет автоматически. Для batch уменьшите размер пачки.
CHESTNYZNAK_BASE_URL отклонёнOverride должен быть https и хостом *.crpt.ru/*.crptech.ru.

API

  • Публичный (без авторизации): GET https://mobile.api.crpt.ru/mobile/check?code=<код>&codeType=<тип> — недокументированный эндпоинт мобильного приложения.
  • Авторизованный (Bearer): https://markirovka.crpt.ru/api/v3/true-api/... — True API (ГИС МТ).

Разработка

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

Лицензия

MIT

Часть WWmcp · Telegram: @vhodvai

來源：README.md，提交 cb7b731

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分