Labelixa — MCP-сервер для Claude Code: рендер и проверка ZPL
Подключает к ИИ-ассистенту рендер, линтинг и разбор термоэтикеток на ZPL, EPL, TSPL и CPCL. Пригодится, когда правки в коде этикетки нужно увидеть до печати.
claude mcp add --transport http zpl https://api.labelixa.com/mcpЧто делает Labelixa
Сервер даёт ассистенту инструменты для работы с языками термопринтеров. zpl_preview рисует этикетку в PNG, zpl_validate и линтеры EPL, TSPL, CPCL возвращают JSON с найденными проблемами и их позициями. Ещё есть генерация штрихкодов в SVG или PNG, определение языка по сырому коду, справка по одной команде ZPL и пересчёт координат между разрешениями 203, 300 и 600 dpi.
Подключиться можно двумя способами. Удалённый сервер по адресу https://api.labelixa.com/mcp отдаёт полный набор инструментов, включая шаблоны, пакетную генерацию и чтение штрихкодов с фото. Локальный пакет labelixa-mcp запускается через npx и даёт ядро из таблицы выше: каждый его инструмент обращается к REST API Labelixa. Ключ lbx_ не обязателен — без него действует анонимная квота по IP.
Проверки стоит знать заранее. zpl_preview — это рендер, а не печать: реальный вывод зависит от принтера, носителя и настроек затемнения. zpl_compatibility не эмулятор и никогда не говорит «работает», только оценивает риск. convert_zpl_dpi не масштабирует встроенные битмапы ^GF и ~DG — при их наличии перед результатом идёт блок предупреждений. Числовые параметры проверяются до запроса: dpmm — 6, 8, 12 или 24, стороны этикетки конечны и не больше 15 дюймов, DPI — 152, 203, 300 или 600.
Какие задачи решает
- отрендерить этикетку ZPL в PNG и посмотреть, что получилось
- найти неизвестные команды и выход за границы макета в коде этикетки
- сгенерировать штрихкод code128 или qrcode отдельным файлом
- определить, на каком языке написан сырой код этикетки
- пересчитать координаты ZPL под другое разрешение принтера
Примеры запросов агенту
- Отрендери эту этикетку ZPL и покажи PNG
- Проверь код этикетки на ошибки, размер 4x6 дюймов
- Сгенерируй qrcode со ссылкой на сайт
Как установить Labelixa
1Командой платформы: удалённый сервер
claude mcp add --transport http zpl https://api.labelixa.com/mcp2Командой платформы
claude mcp add labelixa -- npx -y labelixa-mcp1Командой платформы: удалённый сервер
codex mcp add labelixa --url https://api.labelixa.com/mcp2Командой платформы
codex mcp add labelixa -- npx -y labelixa-mcpФайл настроек
{
"mcpServers": {
"labelixa": {
"url": "https://api.labelixa.com/mcp"
}
}
}{
"mcpServers": {
"labelixa": {
"command": "npx",
"args": [
"-y",
"labelixa-mcp"
]
}
}
}Файл настроек
{
"servers": {
"labelixa": {
"type": "http",
"url": "https://api.labelixa.com/mcp"
}
}
}{
"servers": {
"labelixa": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"labelixa-mcp"
]
}
}
}1Командой платформы: удалённый сервер
gemini mcp add -t http labelixa https://api.labelixa.com/mcp2Командой платформы
gemini mcp add labelixa npx -y labelixa-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Labelixa
Как установить Labelixa в Claude Code?
Для удалённого сервера: claude mcp add --transport http labelixa https://api.labelixa.com/mcp. Локальный вариант: claude mcp add labelixa -- npx -y labelixa-mcp.
Что делает Labelixa?
Даёт ассистенту инструменты для термоэтикеток: рендер ZPL в PNG, линтинг ZPL, EPL, TSPL и CPCL, генерацию штрихкодов, определение языка кода и пересчёт координат между разрешениями.
Нужен ли ключ API для работы?
Нет, ключ lbx_ необязателен. Без него запросы идут по анонимной квоте с ограничением по IP, с ключом расходуется квота аккаунта.
