基本能力
产品定位
Lulu Print MCP Server 是一个专注于按需打印服务的中间件,为开发者提供与 Lulu Print API 的无缝集成。
核心功能
- 打印作业管理:创建和管理书籍及其他印刷品的打印作业,跟踪订单状态,支持每个订单多个项目
- 文件验证:验证内部和封面 PDF 文件,检查尺寸,计算所需封面尺寸,提供详细的验证状态和错误报告
- 成本计算:基于规格计算产品成本,包括运费和税费,支持不同运输级别(从普通邮件到快递)
- 运输管理:按目的地检索可用运输选项,支持国际运输和不同服务级别
- Webhooks:订阅打印作业状态变更,管理 Webhook 端点,测试 Webhook 交付,查看提交历史
适用场景
- 图书自助出版平台
- 个性化印刷品制作服务
- 教育机构教材印刷
- 企业宣传材料印刷
工具列表
- 成本计算工具:
calculate-print-job-cost- 在不创建打印作业的情况下计算成本 - 打印作业管理工具:包括
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等 - 文件验证工具:包括
validate-interior-file,get-interior-validation,calculate-cover-dimensions,validate-cover-file,get-cover-validation等 - 运输工具:
get-shipping-options- 获取可用运输选项 - 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 devDocker 安装
# 使用 Docker Compose 构建和运行
docker-compose up -d
# 或者直接构建和运行 Docker 镜像
docker build -t lulu-print-mcp .
docker run -p 3000:3000 lulu-print-mcp调试方式
- 确保正确配置了
.env文件中的 Lulu API 凭证 - 启用调试日志:设置
DEBUG=true或使用-d标志运行 - 检查网络连接和防火墙设置
- 验证文件 URL 是否可公开访问
- 使用沙盒环境进行测试:设置
LULU_USE_SANDBOX=true或使用-s标志运行
