Chestnyi Znak MCP Server

io.github.woyaxnini由 GitHub 账号 woyaxnini 发布v0.1.1更新于 Oct 24, 2026

MCP server for Chestnyi Znak — Russian product marking system. 10 tools: codes, documents, stocks.

已验证STDIO仅桌面数据与分析商业与电商

概览

AI 生成的概览

本地 MCP 服务器，让助手查询俄罗斯 Chestnyi Znak 商品标识系统中的标识码、单据、仓库余额和企业注册信息。

可以做什么
按商品组列出并查看单据，读取单据内的标识码或按条件搜索标识码，并获取一组标识码的公开信息和按 GTIN 查询商品卡。查询全部商品组的标识码余额，以及单个商品组的虚拟仓库余额。按 INN 核查企业注册状态，并列出某商品组的提货回执。
适用场景
适用于处理俄罗斯商品标识合规事务时，希望用自然语言代替 Chestnyi Znak 网页界面来查询单据、标识码、余额或交易对方注册信息。
运行要求
通过 npx 在本地运行，需要 Node.js。需要 Chestnyi Znak 的 JWT 令牌，以文件路径形式通过 CHZ_TOKEN_FILE 提供；令牌需另行从个人账户获取，涉及 GOST 加密。CHZ_ENV 选择 sandbox 或 prod，默认 prod。
安装前请注意
令牌属于凭据，应妥善保护令牌文件；令牌每 8 至 12 小时过期，需要更换。令牌文件与 CHZ_ENV 必须匹配，否则请求会失败。README 记录的是 CHZ_TOKEN_FILE 和 CHZ_ENV，而清单列出的是 CHZ_TOKEN，安装前请确认实际使用的变量。工具看起来都是只读的，但查询会发送到 Chestnyi Znak 的 True API。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Chestnyi Znak MCP Server，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@woyax/mcp-chestnyi-znak

[License: MIT + Commons Clause]

MCP server for Chestnyi Znak (Честный Знак) — Russia's national product labelling system (True API).

Enables AI assistants (Claude, Cursor, etc.) to query marking codes, documents, warehouse balances, and participant data directly via natural language.

First MCP server for Chestnyi Znak True API.

Tools (10 total)

Documents & Marking Codes

ToolDescription
chz_doc_listList documents for a product group
chz_doc_infoGet details of a specific document by ID
chz_doc_cis_listList marking codes included in a document
chz_cis_searchSearch marking codes by filter criteria
chz_cis_infoGet public info for a list of CIS codes
chz_product_infoGet product card by GTIN

Balance & Reference

ToolDescription
chz_balance_allBalance of marking codes across all product groups
chz_warehouse_balanceVirtual warehouse balance for a product group
chz_participant_checkCheck company registration status by INN
chz_receipt_listList withdrawal receipts for a product group

Development of new tools is ongoing.

Getting a Token

This server requires a JWT token from your Chestnyi Znak personal account. Token acquisition involves GOST cryptography (КриптоПро + УКЭП) and is outside the scope of this package.

Token retrieval can be automated — using a local КриптоПро script, a signing microservice, USB-over-IP with a hardware token, or a cloud HSM. It can also be done manually via the Chestnyi Znak web interface. The right approach depends on your infrastructure, OS, certificate type, and security requirements. Because the options and constraints vary significantly from case to case, this is treated as a separate integration task. We handle this kind of setup as well — feel free to reach out.

Token lifetime: ~8–12 hours. Update the file when it expires — the server picks it up automatically without restart.

Installation & Configuration

Claude Desktop

Add to your claude_desktop_config.json:

Sandbox:

json
{  "mcpServers": {    "chestnyi-znak": {      "command": "npx",      "args": ["-y", "@woyax/mcp-chestnyi-znak"],      "env": {        "CHZ_TOKEN_FILE": "/path/to/your/token",        "CHZ_ENV": "sandbox"      }    }  }}

Production:

json
{  "mcpServers": {    "chestnyi-znak": {      "command": "npx",      "args": ["-y", "@woyax/mcp-chestnyi-znak"],      "env": {        "CHZ_TOKEN_FILE": "/path/to/your/token"      }    }  }}

CHZ_ENV defaults to "prod" if not set.

Important: the token file and the CHZ_ENV value must match — a sandbox token won't work on the production endpoint and vice versa.

Environment Variables

VariableRequiredDefaultDescription
CHZ_TOKEN_FILEYes—Absolute path to file containing the JWT token
CHZ_ENVNoprodContour: sandbox or prod

Author & Support

Built by Oleg Alekseev — ERP/AI integration architect.

Need help integrating AI agents with your ERP, CRM, or Chestnyi Znak? Custom MCP servers, n8n workflows, AI automation — contact me.

License

MIT + Commons Clause © Oleg Alekseev

Free to use for personal and corporate purposes. Selling as a hosted service requires author's permission. See LICENSE for details.

来源：README.md，提交 52c24ab

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.1最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。