AgentSkillsCN

memobird-printer

通过 Memobird MCP 服务器,将内容打印至咕咕机(Memobird)热敏打印机。支持向小型热敏打印机设备输出文本、图片、HTML 以及网页内容。当用户提及“用咕咕机打印”“用咕咕鸡打印”“打印至 Memobird”“咕咕鸡打印”等类似需求,或提出任何将内容发送至 Memobird 设备的请求时,均可使用此技能。触发语句包括:“帮我打印”“用咕咕机打印”“打印至 Memobird”“咕咕鸡打印”,或任何涉及将文本/图片/HTML 打印至小型热敏打印机的类似请求。

SKILL.md
--- frontmatter
name: memobird-printer
description: >
  Print content to a Memobird (咕咕机/咕咕鸡) thermal printer via the Memobird MCP server.
  Supports printing text, images, HTML, and web pages to the small thermal printer device.
  Use this skill when the user mentions: printing with 咕咕机, 咕咕鸡, Memobird, memobrid,
  thermal printer printing, or any request to send content to a Memobird device.
  Triggers include: "帮我打印", "用咕咕机打印", "print to memobird", "咕咕鸡打印",
  or similar requests involving printing text/images/HTML to a small thermal printer.

Memobird Printer

Use the Memobird MCP tools to print content to a 咕咕机 thermal printer. For full tool parameter details, see references/tools.md.

Prerequisites

The MCP server requires env vars:

  • MEMOBIRD_AK (required) — Access Key from open.memobird.cn
  • MEMOBIRD_DEVICE_ID (optional) — default device ID
  • MEMOBIRD_USER_ID (optional) — default user ID from bind_user

If MEMOBIRD_DEVICE_ID and MEMOBIRD_USER_ID are set, they serve as defaults and do not need to be passed per call.

First-Time Setup

If no userID is available, bind the user first:

  1. Call bind_user with the physical device's memobirdID and a useridentifying string
  2. Save the returned userid for all subsequent print calls

Printing Workflow

Choose the appropriate print tool based on content type:

ContentToolNotes
Plain textprint_textSupports Chinese (auto GBK encoding)
HTML snippetprint_from_htmlUse inline CSS, absolute image URLs only
Web pageprint_from_urlStatic/SSR pages only, not JS-heavy SPAs
Image (JPG/PNG)convert_imageprint_imageConvert first, then print the result

After any print call, optionally call get_print_status with the returned printcontentid to verify delivery (printflag=1 = success).

Key Constraints

  • Thermal printer paper width is narrow (~384px for images). Keep content concise.
  • print_image only accepts monochrome bitmap Base64. Always call convert_image first for JPG/PNG sources.
  • print_from_html requires inline CSS — external stylesheets will not load.
  • print_from_url does not render JavaScript — only use with static or server-rendered pages.
  • All print tools accept optional memobirdID and userID that override env-var defaults.

Example Interactions

User: "帮我用咕咕机打印今天的天气预报" → Fetch weather info, then call print_text with the summary.

User: "把这张图片打印到咕咕鸡上" → Call convert_image with the Base64 image, then call print_image with the result.

User: "帮我把这个网页打印出来" (provides URL) → Call print_from_url with the given URL.

User: "打印一个好看的小卡片" → Compose HTML with inline CSS, call print_from_html. Keep width <=384px.