Chestnyi Znak MCP Server

@woyax/mcp-chestnyi-znak

适用于 Chestnyi Znak（Честный Знак）的 MCP 服务——俄罗斯国家产品标签系统（True API）。

可让 AI 助手（Claude、Cursor 等）通过自然语言直接查询标记码、文档、仓库余额和参与方数据。

首个适用于 Chestnyi Znak True API 的 MCP 服务。

---

工具（共 10 个）

文档和标记码

工具	说明
chz_doc_list	列出某个产品组的文档
chz_doc_info	按 ID 获取指定文档的详细信息
chz_doc_cis_list	列出文档中包含的标记码
chz_cis_search	按筛选条件搜索标记码
chz_cis_info	获取一组 CIS 码的公开信息
chz_product_info	按 GTIN 获取产品卡片

余额和参考信息

工具	说明
chz_balance_all	所有产品组的标记码余额
chz_warehouse_balance	某个产品组的虚拟仓库余额
chz_participant_check	按 INN 检查公司注册状态
chz_receipt_list	列出某个产品组的出库收据

新工具正在开发中。

---

获取令牌

此服务需要使用 Chestnyi Znak 个人账户中的 JWT 令牌。获取令牌需要使用 GOST 加密技术（КриптоПро + УКЭП），不在本软件包的范围内。

令牌获取过程可以自动化，例如使用本地 КриптоПро 脚本、签名微服务、通过 USB-over-IP 连接硬件令牌，或使用云 HSM。也可以通过 Chestnyi Znak 网页界面手动获取。合适的方案取决于基础设施、操作系统、证书类型和安全要求。由于各种方案和限制因情况而异，这项工作会作为单独的集成任务处理。我们也提供此类配置服务，欢迎联系。

**令牌有效期：**约 8–12 小时。令牌过期后更新文件即可，服务会自动加载新令牌，无需重启。

---

安装和配置

Claude Desktop

将以下内容添加到 claude_desktop_config.json：

沙盒环境：

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

生产环境：

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

如果未设置，CHZ_ENV 默认为 "prod"。

**重要：**令牌文件和 CHZ_ENV 的值必须匹配——沙盒令牌无法用于生产环境的端点，反之亦然。

---

环境变量

变量	必填	默认值	说明
CHZ_TOKEN_FILE	是	—	包含 JWT 令牌的文件的绝对路径
CHZ_ENV	否	prod	环境：sandbox 或 prod

---

作者和支持

由 Oleg Alekseev 构建——ERP/AI 集成架构师。

• 📧 [email protected] · [email protected]
• 💬 Telegram： @ale_oleg · 频道：@woyax_ai
• 💬 MAX：max.ru/id503610654564_biz

需要将 AI Agent 集成到 ERP、CRM 或 Chestnyi Znak 中？我们提供定制 MCP 服务、n8n 工作流和 AI 自动化服务——联系我。

---

许可证

MIT + Commons Clause © Oleg Alekseev

可免费用于个人和企业用途。将其作为托管服务出售需要获得作者许可。详情请参阅 LICENSE。