@theyahia/chestnyznak-mcp

「Честный ЗНАК」/ ЦРПТ API用のMCPサーバー — 商品マーキングの検証。**5つのツール。**認証不要の公開検証、トークンによるTrue APIからの情報。

Russian API MCPシリーズ（50サーバー）の一部、by @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）

商品名/ブランドでの検索はNational Catalog（nk.crpt.ru）という別のAPIで、ここではサポートされていません。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. УКЭП証明書（CAdES-BES、base64）でdataに署名する。

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