🖨 11 Tools · 70 Formats · 7 Staple Modes · Zero-Token · 3,192 PPD Rules

AIに「印刷して」
と言うだけ

HEIC写真もPhotoshopもAutoCAD(DXF)もMarkdownもOffice文書も、何でも同じ操作で印刷。7種類のステープル、中綴じ製本（タテ・ヨコ）、折り、面付け、パンチをAIが自動制御。

Self-hosted · Proxmox LXC + CUPS + Cloudflare Tunnel
70
対応ファイル形式
11
MCPツール
7
ステープル種類
3,192
PPD制約ルール

📁 70種類のファイル形式

ファイルをアップロードするだけ。AIは形式を意識する必要なし。LXC内で自動判定・変換・印刷。

直接印刷 (12)
PDF, PS, EPS, TXT, JPEG, PNG, TIFF, GIF, BMP — そのままCUPSへ
画像変換 (34)
HEIC/HEIF (iPhone), PSD/PSB (Photoshop), AI (Illustrator), XCF (GIMP), AVIF, WEBP, SVG, TGA, ICO, PCX + カメラRAW 22種 (DNG, CR2, CR3, NEF, ARW, ORF, RAF, RW2, PEF 等)
ImageMagick + libheif + dcraw
ドキュメント変換 (5)
Markdown (.md), HTML, DXF (AutoCAD 2D図面)
pandoc + wkhtmltopdf + ezdxf
Office変換 (19)
DOCX, XLSX, PPTX, DOC, XLS, PPT, CSV, RTF, ODT 等
Graph API → PDF

⚡ ゼロトークン印刷

# curlでアップロード → file_id取得 → MCPで印刷 curl -sF "file=@photo.heic" https://your-printer-mcp.example.com/upload → {"file_id":"abc123"} print_uploaded(file_id="abc123", cups_options={"Duplex":"DuplexNoTumble"}) // HEIC → ImageMagick → JPEG → CUPS → 印刷

📎 ステープル（7種類）

PRESCRIBE Commands Reference のSTTPLコマンド仕様に基づく。

Front
左下コーナー1箇所
✅ 実機確認
Rear
左上コーナー1箇所
DualLeft
左辺2箇所
✅ 実機確認
TopRight
右上コーナー1箇所
DualRight
右辺2箇所
DualTop
上辺2箇所

📖 中綴じ製本

A4タテ 左綴じ
KCBooklet=Left, Fold=True
A3紙→折り→A4冊子
✅ 実機確認
A4ヨコ 上下見開き
+ orientation-requested=4
上辺綴じ、上下にめくる
✅ 実機確認
PPTX 2up→中綴じ
number-up=2 + KCBooklet
横長スライド→A4冊子
✅ 実機確認

⚡ 11 MCPツール

#ツール種別説明
1print_uploadedWメイン印刷。 70形式対応、ゼロトークン
2print_urlWURLダウンロード→変換→印刷
3validate_print_optionsR3,192件PPD + CUPSビルトイン検証
4list_uploadsRアップロード済みファイル一覧
5get_printer_capabilitiesRPPDオプション (filter付)
6get_supported_formatsR対応形式一覧(4カテゴリ)
7list_printersRプリンタ一覧
8get_printer_statusR状態 + トレイ紙設定
9get_print_jobsRキュー一覧
10get_job_statusRジョブ詳細 + CUPSログ
11cancel_print_jobDジョブキャンセル

🤖 ワークフロー

①
get_printer_status
トレイ確認
②
curl /upload
ファイル送信
③
validate
3,192ルール
④
print_uploaded
変換+印刷
⑤
get_job_status
完了確認

🚀 デプロイ手順（10ステップ）

Ubuntu 24.04 + CUPS + Kyoceraドライバ + Cloudflare Tunnel。READMEにコマンド全文の完全ガイドがあります。

Linuxサーバーを用意
Proxmox LXC / VPS / ベアメタル。Ubuntu 24.04推奨。2コア/4GB RAM以上。
基本ソフトをインストール
apt install cups ghostscript nodejs git imagemagick libheif-examples dcraw pandoc wkhtmltopdf + pip3 install ezdxf matplotlib
Kyoceraドライバをインストール
公式サイトからLinux UPD v10.0をDL → dpkg -i kyodialog_10.0-0_amd64.deb。PPDが445個入る。
CUPSにプリンターを登録
lpadmin -p TASKalfa-6054ci -E -v 'socket://プリンターIP:9100' -P /usr/share/ppd/kyocera/機種名.ppd + フィニッシャーオプション設定。テスト印刷で確認。
PPDをカスタマイズ（ステープル追加）
PRESCRIBE仕様書に基づき、DualLeft/TopRight/DualRight/DualTopのStaplePosition値をPPDに追記。READMEにsedコマンドの全文あり。
MCPサーバーをデプロイ
cd /opt && git clone ...printer-mcp-server.git && npm install && npm run build
systemdサービスを作成
/etc/systemd/system/printer-mcp.service を作成。MCP_API_KEY（認証キー）と、Office変換用のGRAPH_*環境変数を設定。systemctl enable --now printer-mcp
Cloudflare Tunnelで公開
cloudflared service install <TOKEN>。ダッシュボードでPublic Hostname → localhost:3000 を設定。ポート開放不要、HTTPS自動。
Claude.aiに接続
Settings → MCP → Add → URL: https://your-domain/mcp?key=YOUR_KEY
動作テスト
「このファイルをA4両面で左2箇所ステープルで印刷して」→ AIがアップロード→検証→印刷→完了確認を自動実行。

📖 README にコピペで使える全コマンドが書かれています。

📚 リファレンス

PRESCRIBE Commands Reference
ステープル位置(STPL)、枚数(STPC)等のコマンド仕様。PPDカスタマイズの根拠。
PDF →
TASKalfa 6054ci Operation Guide
操作ガイド。フィニッシャー操作、用紙設定。
PDF →
OpenPrinting Kyocera PPD
公式PostScript PPDファイル。
Link →

関連 MCP サーバー

堀が公開している MCP サーバー群。すべて Claude.ai / Cursor 等から利用可能。

サーバーツール説明
b2cloud-api14ヤマト B2クラウド送り状発行 API/MCP
cloudflare-mcp69Cloudflare 統合（Tunnel/DNS/Workers/Pages/R2/KV/SSL/Access）
hubspot-ma-mcp128HubSpot MA（CRM/Marketing/Knowledge Store）
msgraph-mcp-server48Microsoft Graph API（Exchange/Teams/OneDrive/SharePoint）
playwright-devtools-mcp57Playwright + Chrome DevTools（ブラウザ自動化）
proxmox-mcp-server35Proxmox VE 仮想化基盤操作
printer-mcp-server ← 今ここ—CUPS ネットワークプリンタ制御（Kyocera TASKalfa）
yamato-printer-mcp-server—ヤマト送り状サーマルプリンタ（ラズパイ + WS-420B）
ssh-mcp-server10SSH クライアント（セッション管理/非同期コマンド）
mac-remote-mcp34macOS リモート制御（Shell/GUI/ファイル/アプリ）
gemini-image-mcp4Gemini/Imagen 画像生成
runpod-mcp36RunPod GPU FaaS（Pods/Endpoints/Jobs）
firecrawl-mcp—Firecrawl セルフホスト Web スクレイピング
ad-ops-mcp62広告運用自動化（Google Ads/Meta/GBP/X）