Labelixa

labelixa-mcp

Labelixa は、サーマルラベル開発向けの MCP（Model Context Protocol）サーバーおよび API プラットフォームです。AI アシスタントや開発者ツールを通じて、サーマルプリンター用ラベル（ZPL、EPL、TSPL、CPCL）のレンダリング、検証、デバッグ、検査、変換を行えます。

接続方法は 2 つあります。

	リモートサーバー（推奨）	この npm パッケージ
エンドポイント	https://api.labelixa.com/mcp	stdio 経由のローカルプロセス
ツールセット	フルセット：レンダリング、検証、デバッグ、変換、バーコード分析、プリンター互換性、テンプレート、一括ジョブ	コアサブセット（下表）；各ツールは Labelixa REST API を呼び出します
インストール	インストール不要	npx -y labelixa-mcp または npm install -g labelixa-mcp
認証	lbx_ API キー（任意）	lbx_ API キー（任意）

リモートサーバーで利用できるツールの一覧は、 labelixa.com/mcp にあります。

リモートサーバー（インストール不要）

トランスポート：Streamable HTTP、POST によるステートレスな JSON-RPC です。匿名での利用は無料で、IP ごとにレート制限が適用されます。API キーを使用する場合は、アカウントのクォータが適用されます。 キー：labelixa.com。

Claude Code：

claude mcp add --transport http labelixa https://api.labelixa.com/mcp

API キーを使用する場合：

claude mcp add --transport http labelixa https://api.labelixa.com/mcp \
  --header "Authorization: Bearer lbx_..."

汎用 MCP クライアントの設定（Claude Desktop、Cursor、その他 url エントリーに対応するクライアント）：

{
  "mcpServers": {
    "labelixa": {
      "url": "https://api.labelixa.com/mcp",
      "headers": {"Authorization": "Bearer lbx_..."}
    }
  }
}

匿名で利用する場合は、headers ブロックを削除してください。

ローカルサーバー（このパッケージ）

npm install -g labelixa-mcp

または、インストールせずに、MCP クライアントの設定から npx で直接実行できます。

{
  "mcpServers": {
    "labelixa": {
      "command": "npx",
      "args": ["-y", "labelixa-mcp"],
      "env": {"LABELIXA_API_KEY": "lbx_..."}
    }
  }
}

環境変数：

• LABELIXA_API_KEY — lbx_ API キー（任意）。指定しない場合は匿名利用のクォータが適用されます。
• LABELIXA_BASE_URL — 任意。既定値は https://api.labelixa.com です。

リクエストでリダイレクトをたどることはないため、サーバーがキーを別のホストに転送することはありません。リクエストを送信する前に数値入力を検証します。dpmm は 6、8、12、24 のいずれか、ラベルの各辺は有限の値で 0 インチより大きく 15 インチ以下、DPI 値は 152、203、300、600 のいずれかである必要があります。

このパッケージのツール

ツール	機能
zpl_preview	ZPL を PNG 画像にレンダリングして確認できます。サーバー側でのレンダリングであり、特定の実機プリンターでのラベル出力を保証するものではありません。
zpl_validate	ZPL を静的解析し、構造化された診断レポート（不明なコマンド、パラメーターの範囲、レイアウトのはみ出し）を JSON 形式で返します。チェックには実際のラベルサイズが必要です。
barcode_generate	単体のバーコード（SVG または PNG）を生成します。対応形式：code128、code39、ean13、upca、upce、itf14、msi、qrcode、datamatrix、pdf417。
language_detect	ラベルコードの生データからプリンター言語（ZPL/EPL/TSPL/CPCL）を検出します。ヒューリスティックによる判定のため、確率ではなく信頼度の段階を返します。
epl_validate	EPL/EPL2 コードを静的解析し、位置情報と重大度を含む検出結果を JSON 形式で返します。
tspl_validate	TSPL/TSPL2 コードを静的解析し、位置情報と重大度を含む検出結果を JSON 形式で返します。
cpcl_validate	CPCL コードを静的解析し、位置情報と重大度を含む検出結果を JSON 形式で返します。
zpl_compatibility	プリンターモデルに対する ZPL の互換性リスクを分析します。エミュレーターではなく、根拠のレベルを示しながら言語の対応状況を報告します。「動作する」と断言することはありません。
zpl_command_help	メンテナンスされているカタログから ZPL コマンドを 1 つ検索し、名前、構文、パラメーター、プレビューエンジンで実際にレンダリングされるかどうかを確認できます。プリンター側のコマンドはレンダリング対象外として表示されます。オプションの locale（デフォルトは en、tr、de）を指定すると、名前と説明のみが翻訳されます。コマンドコード、構文文字列、例、パラメーター名はプロトコルの一部であり、変更されません。
convert_zpl_dpi	プリンター解像度（203/300/600 dpi）間で ZPL の座標を再スケーリングします。埋め込みの ^GF/~DG ビットマップは再スケーリングされません。該当する場合は、出力の前に警告ブロックが表示されます。
explain_zpl	構文、サイズ/DPI、向き、バーコード、フォント、メモリーを網羅した、セクション別の完全なヘルスレポートを正直なスコアとともに提供します。評価できないセクションはスコアに含めず、「未評価」と表示します。

EPL、TSPL、CPCL のプレビュー、ラベルテンプレート、一括生成、 画像からの ZPL 変換、写真からのバーコード読み取りは、 リモートサーバーでのみ利用できます。

ディレクトリへの掲載

• 公式 MCP Registry： com.labelixa/zpl（リモートサーバーとこの npm パッケージ）。
• Smithery：labelixa/zpl。 Smithery は独自のゲートウェイ経由で呼び出しをルーティングします。正規のエンドポイントは https://api.labelixa.com/mcp です。

正確性に関する注意

• エラーにはサーバー独自のメッセージがそのまま含まれます。クォータ超過は、根拠のない待ち時間ではなく、サーバーからの Retry-After とともに報告されます。
• zpl_preview はレンダリングであり、印刷ではありません。実際の出力は、プリンター、メディア、濃度の設定によって異なります。

このパッケージのソース：github.com/Labelixa/labelixa-mcp。 ドキュメント：labelixa.com/docs/api。ライセンス：MIT。