# devlimelabs
## 基本信息
- Slug: `devlimelabs-lulu-print-mcp`
- Source: modelscope
- Publisher: @devlimelabs/lulu-print-mcp
- Categories: ecommerce-and-retail / app-automation
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@devlimelabs/lulu-print-mcp
## 简介
暂无描述。
## MCP Server 详情

# Lulu Print MCP 服务器

一个提供与 Lulu 打印 API 集成的 Model Context Protocol (MCP) 服务器，通过 Claude Desktop 和其他 MCP 客户端为按需打印服务。

## 功能

### 📚 打印作业管理
- 创建和管理书籍及其他印刷材料的打印作业
- 从创建到交付跟踪订单状态
- 在下单前计算成本
- 支持每个订单中的多个项目行

### 📄 文件验证
- 在打印前验证内部 PDF 文件
- 通过尺寸检查验证封面 PDF 文件
- 根据页数计算所需的封面尺寸
- 获取详细的验证状态和错误报告

### 💰 成本计算
- 根据规格计算产品成本
- 包含运费和税费计算
- 支持不同的运输级别（从 MAIL 到 EXPRESS）
- 获取详细的成本明细

### 🚚 运输管理
- 按目的地检索可用的运输选项
- 支持国际运输
- 从标准邮件到快递的不同服务级别

### 🔔 Webhooks
- 订阅打印作业状态变更
- 管理 webhook 终端
- 测试 webhook 传递
- 查看 webhook 提交历史记录

## 安装

### 全局安装

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

# 启动服务器
lulu-print-mcp


### 本地开发

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

# 安装依赖
npm install

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

# 启动开发服务器
npm run dev


### Docker 安装

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

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


## 配置

### 1. 获取 Lulu API 凭证

1. 在 [https://developers.lulu.com/](https://developers.lulu.com/) 注册 Lulu 开发者账户
2. 为了测试，在 [https://developers.sandbox.lulu.com/](https://developers.sandbox.lulu.com/) 创建沙盒账户
3. 导航到您的 [API Keys](https://developers.lulu.com/user-profile/api-keys) 页面
4. 复制您的客户端密钥和客户端密文

### 2. 配置环境变量

bash
# 创建配置文件
cp .env.example .env


编辑 `.env` 文件以包含您的 Lulu API 凭证：


# 必填：您的 Lulu API 凭证
LULU_CLIENT_KEY=your_client_key_here
LULU_CLIENT_SECRET=your_client_secret_here

# 可选：API 端点（已提供默认值）
LULU_API_URL=https://api.lulu.com
LULU_SANDBOX_API_URL=https://api.sandbox.lulu.com
LULU_AUTH_URL=https://api.lulu.com/auth/realms/glasstree/protocol/openid-connect/token
LULU_SANDBOX_AUTH_URL=https://api.sandbox.lulu.com/auth/realms/glasstree/protocol/openid-connect/token

# 使用沙盒环境进行测试（默认：false）
LULU_USE_SANDBOX=false

# 启用调试日志（默认：false）
DEBUG=false


## 与 Claude Desktop 一起使用

将此 MCP 服务器添加到您的 Claude Desktop 配置文件中：

bash
# 运行 Claude Desktop 设置脚本
npm run setup:claude


按照说明更新您的 Claude Desktop 配置文件。该脚本将生成类似以下的配置：

json
{
  "mcpServers": {
    "lulu-print": {
      "command": "lulu-print-mcp",
      "env": {
        "LULU_CLIENT_KEY": "your_client_key",
        "LULU_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}


## 与 Cursor 一起使用

将此 MCP 服务器添加到您的 Cursor 配置文件中：

1. 打开 Cursor 设置 (`Cursor → Settings` 或在 Mac 上 `Cmd+,`)
2. 导航到功能部分
3. 找到“Model Context Protocol”设置
4. 添加以下配置：

json
{
  "mcpServers": {
    "lulu-print": {
      "command": "node",
      "args": ["/path/to/global/lulu-print-mcp/dist/index.js"],
      "env": {
        "LULU_CLIENT_KEY": "your_client_key",
        "LULU_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}或者如果全局安装：

json
{
  "mcpServers": {
    "lulu-print": {
      "command": "lulu-print-mcp",
      "env": {
        "LULU_CLIENT_KEY": "your_client_key",
        "LULU_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}


## 使用Windsurf

将此MCP服务器添加到您的Windsurf配置中：

1. 在项目目录中创建或编辑`.windsurf/config.json`文件
2. 添加以下配置：

json
{
  "mcpServers": {
    "lulu-print": {
      "command": "lulu-print-mcp",
      "env": {
        "LULU_CLIENT_KEY": "your_client_key",
        "LULU_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}


对于使用Windsurf的开发设置：

json
{
  "mcpServers": {
    "lulu-print": {
      "command": "tsx",
      "args": ["src/index.ts"],
      "cwd": "/path/to/lulu-print-mcp",
      "env": {
        "LULU_CLIENT_KEY": "your_client_key",
        "LULU_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}


## 可用工具

### 成本计算

#### calculate-print-job-cost
计算打印作业的成本而不创建它：


calculate-print-job-cost
  line_items: 要定价的项目数组
    - pod_package_id: 产品SKU（例如："0600X0900BWSTDPB060UW444MXX"）
    - page_count: 页数
    - quantity: 副本数量
  shipping_address: 交货地址
    - street1: 街道地址
    - city: 城市名称
    - country_code: 两位ISO国家代码
    - postcode: 邮政编码
    - phone_number: 联系电话
  shipping_option: MAIL | PRIORITY_MAIL | GROUND | EXPEDITED | EXPRESS


### 打印作业管理

#### create-print-job
创建一个新的打印作业订单：


create-print-job
  line_items: 要打印的书籍数组
    - title: 书名
    - cover_url: 封面PDF的URL
    - interior_url: 内页PDF的URL
    - pod_package_id: 产品SKU
    - quantity: 副本数量
  shipping_address: 交货地址
    - name: 收件人姓名
    - street1: 街道地址
    - city: 城市
    - country_code: 两位ISO代码
    - postcode: 邮政编码
    - phone_number: 电话
  contact_email: 订单通信邮箱
  shipping_level: MAIL | PRIORITY_MAIL | GROUND | EXPEDITED | EXPRESS
  external_id: 您的订单参考（可选）


#### list-print-jobs
列出打印作业，可选过滤器：


list-print-jobs
  page: 页码（可选）
  page_size: 每页结果数（可选）
  status: 按状态过滤（可选）
  created_after: 按创建日期过滤（可选）
  created_before: 按创建日期过滤（可选）


#### get-print-job
获取特定打印作业的详细信息：


get-print-job
  id: 打印作业ID


#### update-print-job
更新打印作业（仅在付款前）：


update-print-job
  id: 打印作业ID
  external_id: 新参考（可选）
  contact_email: 新邮箱（可选）


#### cancel-print-job
取消打印作业（仅当未付款时）：


cancel-print-job
  id: 打印作业ID


#### get-print-job-status
获取打印作业的当前状态：


get-print-job-status
  id: 打印作业ID


#### get-print-job-costs
获取打印作业的详细成本：


get-print-job-costs
  id: 打印作业ID


#### get-print-job-statistics
获取一段时间内的打印作业统计信息：


get-print-job-statistics
  start_date: 开始日期 (YYYY-MM-DD)（可选）
  end_date: 结束日期 (YYYY-MM-DD)（可选）
  group_by: DAY | WEEK | MONTH（可选）


### 文件验证

#### validate-interior-file
验证内页PDF文件：


validate-interior-file
  file_url: 内页PDF的URL
  pod_package_id: 产品SKU（可选，用于标准化）


#### get-interior-validation
检查验证状态：


get-interior-validation
  validation_id: 来自validate-interior-file的ID


#### calculate-cover-dimensions
计算所需的封面尺寸：


calculate-cover-dimensions
  pod_package_id: 产品SKU
  page_count: 内页页数
  unit: IN | MM | PT（可选，默认：PT）#### validate-cover-file
验证封面PDF文件：


validate-cover-file
  file_url: 封面PDF的URL
  pod_package_id: 产品SKU
  page_count: 内页页数


#### get-cover-validation
检查封面验证状态：


get-cover-validation
  validation_id: 从validate-cover-file获取的ID


### 运输

#### get-shipping-options
获取可用的运输选项：


get-shipping-options
  country_code: 2位ISO国家代码
  state_code: 州/省代码（可选）
  quantity: 物品数量（可选）
  pod_package_id: 产品SKU（可选）
  page_count: 页数（可选）
  level: 按特定级别筛选（可选）


### Webhooks

#### create-webhook
创建Webhook订阅：


create-webhook
  ur…