AI导哈

热敏打印服务器

Memobird MCP服务器是一款基于Node.js的热敏打印服务，支持绑定用户设备、打印文本、图像及网页内容。

  • by CafuChino
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 CafuChino/memobirdMCP

使用说明

Memobird MCP服务器

MCP服务器 Memobird (咕咕机) 热敏打印机，基于 记忆鸟.

先决条件

  • Node.js>=18
  • Memobid访问密钥（来自 open.memobird.cn)
  • Memobird设备ID（双击设备将其打印出来）

设置

npm install
npm run build

配置

环境变量 必填 说明
MEMOBIRD_AK 是 访问密钥来自open.memobird.cn
MEMOBIRD_DEVICE_ID 否 设备ID来自 bind_user，如果已设置，则跳过绑定
MEMOBIRD_USER_ID 否 用户ID来自 bind_user，如果已设置，则跳过绑定

用法

通过npx（推荐）

不需要本地克隆。添加以下配置以直接使用已发布的npm包。

克劳德代码 --添加到 ~/.claude/settings.json:

首次设置（仅限 MEMOBIRD_AK 需要， bind_user 将被自动调用）：

{
  "mcpServers": {
    "memobird": {
      "command": "npx",
      "args": ["-y", "memobirdmcp"],
      "env": {
        "MEMOBIRD_AK": "your-access-key"
      }
    }
  }
}

首次绑定后，添加返回的 userid 和 memobirdID 跳过 bind_user 在今后的会议上：

{
  "mcpServers": {
    "memobird": {
      "command": "npx",
      "args": ["-y", "memobirdmcp"],
      "env": {
        "MEMOBIRD_AK": "your-access-key",
        "MEMOBIRD_DEVICE_ID": "your-device-id",
        "MEMOBIRD_USER_ID": "12345"
      }
    }
  }
}

克劳德桌面 --添加到 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS），与上述env格式相同。

通过本地建设

如果您更喜欢从源代码运行：

{
  "mcpServers": {
    "memobird": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"],
      "env": {
        "MEMOBIRD_AK": "your-access-key"
      }
    }
  }
}

工具

bind_user

将用户标识符绑定到Memobird设备。 如果发生以下情况，必须先呼叫 MEMOBIRD_DEVICE_ID 和 MEMOBIRD_USER_ID 未设置环境变量。 返回a userid 和 memobirdID --将它们保存到env-var中，以便在以后的会话中跳过此步骤。

参数 类型 必填 说明
memobirdID string 是 设备ID（双击设备获取）
useridentifying string 是 您的唯一用户标识符

print_text

将文本内容打印到绑定设备。支持中文字符（自动GBK编码）。

参数 类型 必填 说明
text string 是 要打印的文本内容

打印图像

将单色位图图像打印到绑定的设备。使用 convert_image 首先转换JPG/PNG。

参数 类型 必填 说明
base64Image string 是 单色位图为Base64

print_from_url

将web URL中的内容打印到绑定设备。最适合静态/服务器渲染的页面。

参数 类型 必填 说明
url string 是 要打印的URL

print_from_html

将HTML源中的内容打印到绑定设备。使用内联CSS和绝对图像URL。

参数 类型 必填 说明
html string 是 HTML源代码

get_print_status

检查已提交打印作业的状态。

参数 类型 必填 说明
printcontentid string 是 从打印工具响应中打印内容ID

退货 printflag: 1 如果打印成功， 0 如果待定/失败。

convert_image

将JPG/PNG图像转换为单色位图格式进行打印。使用384px宽度可获得最佳效果。

参数 类型 必填 说明
base64Image string 是 JPG或PNG图像为Base64格式

典型工作流程

第一次

  1. 呼叫 bind_user 带有您的设备ID和用户标识符
  2. 保存返回的 userid 和 memobirdID 到 MEMOBIRD_USER_ID 和 MEMOBIRD_DEVICE_ID MCP配置中的env变量
  3. 根据需要使用打印工具

后续会话（环境变量集）

  1. 使用 print_text / print_from_html / print_from_url 直接（无需绑定）
  2. 图片：致电 convert_image 首先，然后 print_image 结果
  3. 可选呼叫 get_print_status 检查打印是否完成

许可证

国际学生委员会

相关 MCP