@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）

按名称/品牌搜索属于 Национальный каталог（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 — 字符串枚举：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 形式发送）。УКЭП 签名在服务器外部完成（例如通过 КриптоПро）——这里没有内置的 ГОСТ 签名。注册仅对法人/个体工商户开放，地址为 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