Skip to main content
Glama
Sign In
TepraMCP

TepraMCP

by swmr71
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

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: labelprint

セットアップ

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 で探してください。

環境変数

変数

用途

TEPRA_PRINTER_IP

プリンターの IP アドレス（既定値）

TEPRA_FONT

使用フォントの CSS スタック。未設定ならシステムの日本語フォントを自動選択

TEPRA_FONT_DIR

日本語フォントを持たない環境（コンテナ等）でフォントを読み込むディレクトリ

使い方

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

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

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

ラベルの指定項目

引数

説明

text

行の配列。テープ幅いっぱいになるよう自動で文字サイズを決定

qr

左端に置く QR コードの内容

imagePath / imageBase64

貼り込む PNG/JPEG

tapeWidthMm

4/6/9/12/18/24/36。省略時はプリンターから自動検出

lengthMm / minLengthMm

ラベル長の固定／最低長の指定

align

ラベルに余白がある場合の寄せ方向

marginMm

前後の余白（既定 2mm）

bold

太字（既定 true）

halfCut

ハーフカット（tepra_print のみ、既定 true）

copies

同一ラベルの連続印刷枚数（tepra_print のみ）

制限

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

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

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

ライセンス

Apache-2.0

Available Tools

4 tools
tepra_discoverFind TEPRA printersA

Search the local network for TEPRA printers via mDNS and return their IP addresses.

Inputs: timeoutMs.

tepra_previewPreview a TEPRA labelA

Render a label and return it as an image without printing. Use this to check the layout before spending tape.

Inputs: qr, bold, text, align, +8 more.

tepra_printPrint a TEPRA labelA

Render and print a label on the TEPRA SR5900P. Consumes tape — preview first if the layout is uncertain.

Inputs: qr, bold, text, align, +10 more.

tepra_statusTEPRA statusA

Report whether the printer is ready and which tape cartridge is loaded.

Inputs: printer.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4.3/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clear, distinct purpose: discovery, status checking, preview, and printing. There is no overlap; an agent can easily choose the right tool for the task.

    Naming Consistency5/5

    All tool names follow a consistent pattern of 'tepra_' followed by a verb (discover, status, preview, print). This makes the tool set predictable and easy to navigate.

    Tool Count5/5

    Four tools is a well-scoped count for a printer control server. Each tool serves a necessary function in the label printing workflow, and none are redundant.

    Completeness5/5

    The tool set covers the full workflow: discovering printers, checking status, previewing the label, and printing. There are no obvious missing operations for the domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    • Printful MCP Server and API by CotletA
      dev.cotlet

      Printful MCP server for ChatGPT, Claude and any AI agent: list orders, create draft order, confirm order, check shipping rates, list sync products, upload design file, generate mockups and cancel order in your own Printful account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Printful yourself; Cotlet does not store your password and you need no Printful API key. About the official Printful API: Printful has a full REST API, documented at developers.printful.com, with private tokens for your own store and OAuth for public apps, but no official MCP server (checked 17 Oct 2026). The API docs never mention MCP. Setup and FAQ: https://cotlet.dev/integrations/printful-api-mcp-server

      Content Management SystemsMarketingSocial Media
      341
      https://cotlet.dev/mcp/v1/printful
    • Procountor MCP Server and API by CotletB
      dev.cotlet

      Procountor MCP server for ChatGPT, Claude and any AI agent: create invoice, approve invoice, create receipt, add partner and list unpaid invoices in your own Procountor account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Procountor yourself; Cotlet does not store your password and you need no Procountor API key. About the official Procountor API: Yes, Procountor has a REST API with write access to invoices, ledger receipts and business partners, but you cannot just switch it on (checked 14 Oct 2026). You request a test environment and client credentials, ask Procountor for production access, and the company needs a Procountor Financials environment with API access enabled; usage may carry monthly fees. Setup and FAQ: https://cotlet.dev/integrations/procountor-api-mcp-server

      CRMFinancePayments & Billing
      311
      https://cotlet.dev/mcp/v1/procountor
    • Expensify MCP Server and API by CotletA
      dev.cotlet

      Expensify MCP server for ChatGPT, Claude and any AI agent: create expense, attach receipt, create report, submit report and approve report in your own Expensify account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Expensify yourself; Cotlet does not store your password and you need no Expensify API key. About the official Expensify API: Yes, but it is narrow (checked 14 Oct 2026). Expensify's Integration Server API creates expenses, creates reports (domain and policy admins, after enablement) and exports reports, with credentials you generate yourself. Setup and FAQ: https://cotlet.dev/integrations/expensify-api-mcp-server

      CRMFinancePayments & Billing
      311
      https://cotlet.dev/mcp/v1/expensify
    • Pirate Ship MCP Server and API by CotletA
      dev.cotlet

      Pirate Ship MCP server for ChatGPT, Claude and any AI agent: get rates, buy labels in bulk, import orders, track shipment and refund labels in your own Pirate Ship account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Pirate Ship yourself; Cotlet does not store your password and you need no Pirate Ship API key. About the official Pirate Ship API: Pirate Ship has no API (checked 11 Oct 2026). Its help center says so and points to store integrations and spreadsheet uploads instead. Setup and FAQ: https://cotlet.dev/integrations/pirate-ship-api-mcp-server

      App AutomationCalendar ManagementCRM
      3116
      https://cotlet.dev/mcp/v1/pirate-ship

    Related MCP Servers

    • labelprint

      permitzip
      A
      license
      A
      quality
      C
      maintenance
      Enables printing PNG labels to a nearby thermal label printer over local serial or Bluetooth, with tools for rendering previews, checking printer status, and printing with confirmation.
      5
      1
      MIT

    • niimbot-mcp

      italocjs
      F
      license
      Not graded
      quality
      C
      maintenance
      Enables printing text, QR codes, and images directly to NIIMBOT B1 BLE label printers without vendor apps or cloud, with orientation control, fit validation, and local preview tools.
      -

    • ptouch-mcp

      jacobhaynes
      A
      license
      Not graded
      quality
      B
      maintenance
      Enables printing labels on Brother P-touch tape printers via MCP, allowing natural language requests to create, preview, and print labels.
      MIT