Memobird MCP

Memobird MCP服务器

先决条件

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

设置

npm install
npm run build

配置

用法

通过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中，以便在以后的会话中跳过此步骤。

print_text

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

打印图像

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

print_from_url

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

print_from_html

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

get_print_status

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

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

convert_image

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

典型工作流程

第一次

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 检查打印是否完成

许可证

国际学生委员会