| name | printer |
| description | 列印功能 |
| allowed-tools | prepare_print_file mcp__printer__print_file mcp__printer__list_printers mcp__printer__printer_status mcp__printer__cancel_job mcp__printer__print_test_page |
| metadata | {"ctos":{"requires_app":"printer","mcp_servers":"printer ching-tech-os"}} |
【列印功能】
列印分兩步驟,先轉換路徑再列印:
步驟 1 - 準備檔案(ching-tech-os 工具):
- prepare_print_file: 將虛擬路徑轉換為絕對路徑,Office 文件自動轉 PDF
· file_path: 檔案路徑(必填)
- 虛擬路徑:ctos://knowledge/attachments/report.pdf、shared://projects/...
- 絕對路徑:/mnt/nas/ctos/...
· 回傳:可列印的絕對路徑
步驟 2 - 實際列印(printer-mcp 工具):
- mcp__printer__print_file: 將檔案送至印表機列印
· file_path: 步驟 1 回傳的絕對路徑(必填)
· printer: 印表機名稱(可選,預設使用系統預設)
· copies: 份數(可選,預設 1)
· page_size: 紙張大小(可選,A3/A4/A5/B4/B5/Letter/Legal)
· orientation: 方向(可選,portrait/landscape)
· color_mode: 色彩模式(可選,gray/color,預設 gray。除非用戶要求彩色列印,否則一律用 gray)
- mcp__printer__list_printers: 查詢可用印表機
- mcp__printer__printer_status: 查詢印表機狀態
- mcp__printer__cancel_job: 取消列印工作
⚠️ 重要:不要跳過步驟 1 直接呼叫 printer-mcp!
虛擬路徑(ctos://、shared://)必須先經過 prepare_print_file 轉換。
只有當你已經有絕對路徑(/mnt/nas/...)時才能直接用 printer-mcp。
【支援的檔案格式】
- PDF:自動透過 Ghostscript 正規化(修復 AutoCAD 等軟體產生的格式問題,確保 RICOH 等嚴格 PDF 解譯器能接受)
- 純文字(.txt, .log, .csv)、圖片(PNG, JPG, JPEG, GIF, BMP, TIFF, WebP):直接列印
- 自動轉 PDF:Office 文件(.docx, .xlsx, .pptx, .doc, .xls, .ppt, .odt, .ods, .odp)
【列印使用情境】
- 用戶說「把知識庫的報告印出來」
→ search_knowledge("報告") 找到檔案路徑
→ prepare_print_file(file_path="ctos://knowledge/...")
→ mcp__printer__print_file(file_path="回傳的絕對路徑")
- 用戶說「印 3 份 A3 橫式」
→ prepare_print_file(file_path=...)
→ mcp__printer__print_file(file_path=..., copies=3, page_size="A3", orientation="landscape")
- 用戶說「列出印表機」
→ mcp__printer__list_printers()(不需要步驟 1)