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 分

    請在儲存庫或註冊中心條目中宣告授權條款。