Chestny ZNAK MCP 服务器（chestny-znak-mcp-ru）是一个面向俄罗斯商品强制标记系统（Честный знак，含 ГИС МТ 与 СУЗ）的 MCP 服务器，用于让 AI 助手调用该系统的 API。
用途 该服务器把俄罗斯商品标记系统的接口封装为 MCP 工具，供 AI 助手查询和操作标记相关数据，包括：标记代码信息、按过滤条件导出数据、按 GTIN 查询商品流转路径、发射订单（заказы на эмиссию）、贴标报告、真伪验证。
主要能力 仓库中的 crpt_mcp/endpoints.yaml 收录了 33 个方法，其中 24 个为只读方法，9 个为写入方法，0 个不可逆方法。服务器严格按该文件执行。工具采用三工具模式而非直接暴露 33 个函数：代理先按关键词查找方法，再读取方法卡片，最后调用。写入和不可逆操作需要确认。方法带三级访问类别：读取直接执行，写入和不可逆操作需确认。典型使用场景包括：在收货前检查一批标记代码、查看 СУЗ 中代码发射订单的状态、导出归属于某个流通参与方的代码、按 GTIN 查看商品流转路径。
使用方式 有两种安装路径，视是否有终端而定。 无终端：从 releases 页面下载 chestny-znak-mcp-ru-vX.Y.Z.mcpb 文件并双击打开，Claude Desktop 会自行安装服务器并在独立窗口询问密钥，无需编辑配置文件。需要 Python 3.10 或更高版本，依赖在首次启动时自动安装。 手动配置：在 Claude Desktop 的 claude_desktop_config.json 中配置。 认证方式：GET /api/v3/true-api/auth/key 返回随机数据，用户在机器上通过 КриптоПро 用 КЭП 签名，然后 POST /api/v3/true-api/auth/simpleSignIn 用签名换取令牌。令牌有效期约 10 小时。私钥不会进入服务器。密钥可不放在环境变量中：服务器支持“柜”（кабинеты），将其保存到 ~/.ru-mcp/cabinets.json，权限为 600，位于仓库之外。 安装检查：命令会打印加载的方法数量、是否找到密钥以及来源，不显示机密；加 --live 会执行一次低成本的只读真实调用。
适用场景 适用于需要与俄罗斯商品标记系统交互的 AI 助手工作流，例如商品收货前的代码批量检查、发射订单状态跟踪、流通参与方代码导出、按 GTIN 的商品路径查询等。
限制与说明 ЦРПТ 文档开放，地址为 https://docs.crpt.ru/gismt/True_API/，但没有机器可读的规范：/api/v3/true-api/swagger.json 返回 401。因此目录不是从规范生成，而是依据开放 SDK 整理，每条记录都标注 verified: false。这是一张用于侦察的地图：路径可靠，动词和参数需与文档及实际环境核对。服务器在 describe_method 中显示该状态，避免代理把猜测当作事实。 数据与隐私：服务器不收集或传输用户数据，密钥本地保存在 ~/.ru-mcp/cabinets.json，请求只发往 Честный знак API（ГИС МТ 与 СУЗ），无遥测。完整说明见 PRIVACY_POLICY.md。 核心已抽离到 schema-mcp-core。相邻服务器：vk-mcp-ru、diadoc-mcp-ru、sbis-mcp-ru。电商平台单独位于 marketplaces-mcp-ru。 许可：MIT。作者：Илья Утов。
