AI导哈

Lulu 按需打印服务

Lulu Print MCP Server 是一个模型上下文协议（MCP）服务器，提供与 Lulu Print API 的集成，用于通过 Claude Desktop 和其他 MCP 客户端实现按需打印服务。该服务提供打印作业管理、文件验证、成本计算、运输管理和 Webhooks 等功能，适用于图书出版、个性化印刷品制作等场景。

  • by devlimelabs
  • 更新于
在 GitHub 查看 devlimelabs/lulu-print-mcp

使用说明

基本能力

产品定位

Lulu Print MCP Server 是一个专注于按需打印服务的中间件，为开发者提供与 Lulu Print API 的无缝集成。

核心功能

  • 打印作业管理：创建和管理书籍及其他印刷品的打印作业，跟踪订单状态，支持每个订单多个项目
  • 文件验证：验证内部和封面 PDF 文件，检查尺寸，计算所需封面尺寸，提供详细的验证状态和错误报告
  • 成本计算：基于规格计算产品成本，包括运费和税费，支持不同运输级别（从普通邮件到快递）
  • 运输管理：按目的地检索可用运输选项，支持国际运输和不同服务级别
  • Webhooks：订阅打印作业状态变更，管理 Webhook 端点，测试 Webhook 交付，查看提交历史

适用场景

  • 图书自助出版平台
  • 个性化印刷品制作服务
  • 教育机构教材印刷
  • 企业宣传材料印刷

工具列表

  1. 成本计算工具：calculate-print-job-cost - 在不创建打印作业的情况下计算成本
  2. 打印作业管理工具：包括 create-print-job, list-print-jobs, get-print-job, update-print-job, cancel-print-job, get-print-job-status, get-print-job-costs, get-print-job-statistics 等
  3. 文件验证工具：包括 validate-interior-file, get-interior-validation, calculate-cover-dimensions, validate-cover-file, get-cover-validation 等
  4. 运输工具：get-shipping-options - 获取可用运输选项
  5. Webhook 工具：包括 create-webhook, list-webhooks, get-webhook, update-webhook, delete-webhook, test-webhook, list-webhook-submissions 等

使用教程

使用依赖

需要安装 Node.js 和 npm。

安装教程

全局安装

# 全局安装包
npm install -g @devlimelabs/lulu-print-mcp

# 启动服务器
lulu-print-mcp

本地开发

# 克隆仓库
git clone https://github.com/devlimelabs/lulu-print-mcp.git
cd lulu-print-mcp

# 安装依赖
npm install

# 设置开发环境
npm run setup:dev

# 启动开发服务器
npm run dev

Docker 安装

# 使用 Docker Compose 构建和运行
docker-compose up -d

# 或者直接构建和运行 Docker 镜像
docker build -t lulu-print-mcp .
docker run -p 3000:3000 lulu-print-mcp

调试方式

  1. 确保正确配置了 .env 文件中的 Lulu API 凭证
  2. 启用调试日志：设置 DEBUG=true 或使用 -d 标志运行
  3. 检查网络连接和防火墙设置
  4. 验证文件 URL 是否可公开访问
  5. 使用沙盒环境进行测试：设置 LULU_USE_SANDBOX=true 或使用 -s 标志运行

相关 MCP