MCP-сервер Честного знака
chestnyznak-mcp
MCP-сервер проверки маркировки Честного знака: публичные проверки кодов без токена и данные True API ЦРПТ по токену
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Публичные инструменты только читают статус маркировки, ничего не меняют в системе Честного знака
- Авторизованные инструменты передают токен True API, храните его только в переменных окружения
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/chestnyznak-mcpОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале
claude mcp add --transport stdio chestnyznak -- npx -y @theyahia/chestnyznak-mcpИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"chestnyznak": {
"command": "npx",
"args": [
"-y",
"@theyahia/chestnyznak-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"chestnyznak": {
"command": "npx",
"args": [
"-y",
"@theyahia/chestnyznak-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
code --add-mcp '{"name":"chestnyznak","type":"stdio","command":"npx","args":["-y","@theyahia/chestnyznak-mcp"]}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"chestnyznak": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@theyahia/chestnyznak-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Выполните в терминале
codex mcp add chestnyznak -- npx -y @theyahia/chestnyznak-mcpИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.chestnyznak]
command = "npx"
args = ["-y", "@theyahia/chestnyznak-mcp"]Если файл уже есть, допишите блок в конец.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"chestnyznak": {
"command": "npx",
"args": [
"-y",
"@theyahia/chestnyznak-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"chestnyznak": {
"command": "npx",
"args": [
"-y",
"@theyahia/chestnyznak-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"chestnyznak": {
"command": "npx",
"args": [
"-y",
"@theyahia/chestnyznak-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"chestnyznak": {
"command": "npx",
"args": [
"-y",
"@theyahia/chestnyznak-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"chestnyznak": {
"type": "local",
"command": [
"npx",
"-y",
"@theyahia/chestnyznak-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"chestnyznak": {
"command": "npx",
"args": [
"-y",
"@theyahia/chestnyznak-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"chestnyznak": {
"command": "npx",
"args": [
"-y",
"@theyahia/chestnyznak-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Подключи сервер командой claude mcp add chestnyznak -- npx -y @theyahia/chestnyznak-mcp, а для авторизованных инструментов задай переменную CHESTNYZNAK_TOKEN с токеном True API.
Другие способы из описания автора
{
"mcpServers": {
"chestnyznak": {
"command": "npx",
"args": ["-y", "@theyahia/chestnyznak-mcp"]
}
}
}Работает сразу без токена для трех публичных инструментов.
Проверка безопасности
Как мы проверяемНизкий рискНизкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
- Публичные инструменты только читают статус маркировки, ничего не меняют в системе Честного знака
- Авторизованные инструменты передают токен True API, храните его только в переменных окружения
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту проверить код маркировки Честного знака (DataMatrix, QR или EAN13) и получить статус подлинности, название товара, категорию, производителя и владельца вместо ручного похода в личный кабинет. Три публичных инструмента работают без регистрации: проверка одного кода, подробная карточка товара и пакетная проверка до 50 кодов за раз. Два инструмента с авторизацией по токену True API ищут товар по GTIN и получают информацию о CIS (коде идентификации). Сервер входит в серию WWmcp того же автора: общее ядро дает повторы запросов и два транспорта, stdio и Streamable HTTP, а HTTP по умолчанию слушает только localhost и без аутентификации на /mcp.
Для кого. Для товароведов, закупщиков и служб контроля качества, которым нужно быстро проверять маркировку товаров без входа в личный кабинет Честного знака.
Подходит, если
- Нужно быстро проверить код DataMatrix на подлинность прямо в диалоге с агентом
- Нужна пакетная проверка партии кодов маркировки до 50 штук за раз
- Есть токен True API и нужен поиск товара по GTIN или информация по CIS
Не подходит, если
- Нужен поиск товара по названию или бренду: это отдельный API Национального каталога, здесь не поддерживается
- Нужно подавать или изменять данные в системе маркировки, а не только проверять
- Нужен доступ извне localhost без настройки собственной аутентификации на HTTP-эндпоинте
Пример запроса к агенту
Проверь код маркировки 0104600702028445 и скажи, кто владелец и производитель товараMCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
CHESTNYZNAK_TOKENсекрет- Токен True API для инструментов search_products и get_cis_info
CHESTNYZNAK_BASE_URL- Origin авторизованного API, только https-хосты crpt.ru или crptech.ru
Ограничения
Поиск по GTIN и данные CIS требуют токена True API ЦРПТ. Поиск товара по названию или бренду не поддерживается, для него нужен отдельный API Национального каталога. HTTP-режим по умолчанию открыт только на localhost и не имеет собственной аутентификации, открывать наружу флагом --host=0.0.0.0 предлагается на свой риск.
Как отключить. Выполните claude mcp remove chestnyznak или удалите блок chestnyznak из конфигурации MCP-клиента.
Частые вопросы
Нужен ли токен для проверки кода?
Нет, три публичных инструмента check_marking_code, get_product_info и check_batch работают без регистрации и токена.
Можно искать товар по названию?
Нет, для этого нужен отдельный API Национального каталога nk.crpt.ru, этот сервер его не покрывает.
Похожие
MCP-серверыУтилита Microsoft и MCP-сервер, которые переводят PDF, Word, Excel, PowerPoint, HTML и другие файлы в Markdown для модели
Скиллы Anthropic
Skills
Официальные примеры скиллов Anthropic: документы docx, pdf, pptx, xlsx, дизайн, MCP builder и спецификация Agent Skills
Скилл, который собирает редактируемые PPTX-презентации из PDF, DOCX, ссылок и Markdown с настоящими фигурами, диаграммами и анимациями
Скилл рисует редакторские диаграммы как самостоятельные файлы HTML и SVG: архитектура, блок-схемы, ER, воронки и еще около сорока типов
Коротко о README
README на русском объясняет назначение сервера прямым языком: проверить код маркировки без личного кабинета. Показаны конфигурации для Claude Desktop с токеном и без, команда для Claude Code и запуск в режиме Streamable HTTP с защитой от DNS-rebinding. Таблицы описывают три переменные окружения и все пять инструментов с аргументами, отдельно разобран формат JSON-ответа check_marking_code и get_product_info с примерами полей status и владельца.