# Labelixa

Подключает к ИИ-ассистенту рендер, линтинг и разбор термоэтикеток на ZPL, EPL, TSPL и CPCL. Пригодится, когда правки в коде этикетки нужно увидеть до печати.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: Labelixa
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Labelixa/labelixa-mcp
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/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.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://api.labelixa.com/mcp`

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http zpl https://api.labelixa.com/mcp
```

2. **Командой платформы**
```bash
claude mcp add labelixa -- npx -y labelixa-mcp
```

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add labelixa --url https://api.labelixa.com/mcp
```

2. **Командой платформы**
```bash
codex mcp add labelixa -- npx -y labelixa-mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "labelixa": {
            "url": "https://api.labelixa.com/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "labelixa": {
            "command": "npx",
            "args": [
                "-y",
                "labelixa-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "labelixa": {
            "type": "http",
            "url": "https://api.labelixa.com/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "labelixa": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "labelixa-mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http labelixa https://api.labelixa.com/mcp
```

2. **Командой платформы**
```bash
gemini mcp add labelixa npx -y labelixa-mcp
```

## Когда брать
- отрендерить этикетку ZPL в PNG и посмотреть, что получилось
- найти неизвестные команды и выход за границы макета в коде этикетки
- сгенерировать штрихкод code128 или qrcode отдельным файлом
- определить, на каком языке написан сырой код этикетки
- пересчитать координаты ZPL под другое разрешение принтера

## Примеры запросов агенту
- Отрендери эту этикетку ZPL и покажи PNG
- Проверь код этикетки на ошибки, размер 4x6 дюймов
- Сгенерируй qrcode со ссылкой на сайт

## Похожие
- [dtg-base](https://affpapa.org/nevibecode/skills/dtg-base.md) — скилл · 327 установок
- [Nutrition MCP](https://affpapa.org/nevibecode/mcp/nutrition-mcp.md) — MCP-сервер · ★ 81
- [Scandit](https://affpapa.org/nevibecode/mcp/scandit.md) — MCP-сервер · ★ 20
- [vision-framework](https://affpapa.org/nevibecode/skills/vision-framework.md) — скилл · 3800 установок
- [axiom-vision](https://affpapa.org/nevibecode/skills/axiom-vision.md) — скилл · 1800 установок
- [syncfusion-react-barcode](https://affpapa.org/nevibecode/skills/syncfusion-react-barcode.md) — скилл · 711 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md