TepraMCP

キングジムのラベルプリンター 「テプラ」PRO SR5900P を Wi-Fi/LAN 経由で操作する MCP サーバーです。 Claude などの MCP クライアントから、日本語テキスト・QRコード・画像を載せたラベルを直接印刷できます。

tepra_discover  … ネットワーク上のテプラを探す
tepra_status    … 電源・カバー・装着テープ幅を確認
tepra_preview   … 印刷せずにラベル画像を返す（テープを無駄にしない）
tepra_print     … 実際に印刷する

動作原理

SR5900P は UDP/9100 を制御チャネル、TCP/9100 をラスターデータの転送に使う独自プロトコルを話します。 本実装はその解析結果（Mine02C4 / hikalium/sr5900p）に基づく 非公式 の再実装です。 公式ドライバやテプラクリエイターのインストールは不要ですが、本体ファームウェアの更新で 動かなくなる可能性がある点はご承知おきください。

印刷解像度は 360dpi。ラベルは 1bpp に二値化され、テープ送り方向に 1 列ずつ転送されます。

Related MCP server: mcp-server-zipcode-jp

セットアップ

npm install && npm run build

MCP クライアントの設定に追加します（claude_desktop_config.json や .mcp.json）:

{
  "mcpServers": {
    "tepra": {
      "command": "node",
      "args": ["C:/Users/swmr7/Documents/GitHub/TepraMCP/dist/index.js"],
      "env": {
        "TEPRA_PRINTER_IP": "192.168.1.50"
      }
    }
  }
}

TEPRA_PRINTER_IP を設定しておくと毎回 IP を指定せずに済みます。未設定の場合は各ツールの printer 引数で渡すか、まず tepra_discover で探してください。

環境変数

使い方

自然言語で頼めば十分です。

「会議室A / 3F 北側」って2行のラベルを18mmテープで印刷して

このURLのQRコード付きラベルをプレビューして

ラベルの指定項目

制限

• 印刷は 1 行レイアウト（[QR][画像][テキスト]）に固定です。枠線や複雑な組版は未対応。

• テープカートリッジの色は判別しません（プリンターが幅しか返さないため）。

• tepra_discover は mDNS を使うため、プリンターと同一サブネットにいる必要があります。

ライセンス

Apache-2.0