Lulu Print MCP 서버
Claude Desktop 및 기타 MCP 클라이언트를 통한 주문형 인쇄 서비스를 위한 Lulu Print API와의 통합을 제공하는 MCP(Model Context Protocol) 서버입니다.
특징
📚 인쇄 작업 관리
- 책 및 기타 인쇄물에 대한 인쇄 작업을 만들고 관리합니다.
- 주문 생성부터 배송까지 주문 상태를 추적하세요
- 주문하기 전에 비용을 계산하세요
- 주문당 여러 라인 항목 지원
📄 파일 검증
- 인쇄하기 전에 내부 PDF 파일을 검증하세요
- 치수 검사를 통해 표지 PDF 파일 검증
- 페이지 수를 기준으로 필요한 표지 크기를 계산합니다.
- 자세한 검증 상태 및 오류 보고 받기
💰 비용 계산
- 사양에 따라 제품 비용을 계산합니다.
- 배송비와 세금 계산 포함
- 다양한 배송 레벨 지원(MAIL에서 EXPRESS까지)
- 자세한 비용 내역을 확인하세요
🚚 배송 관리
- 목적지별로 사용 가능한 배송 옵션을 검색합니다.
- 국제 배송 지원
- 표준 우편부터 익스프레스 배송까지 다양한 서비스 수준
🔔 웹훅
- 인쇄 작업 상태 변경 구독
- 웹훅 엔드포인트 관리
- 웹훅 전달 테스트
- 웹훅 제출 내역 보기
설치
글로벌 설치
지엑스피1
지역 개발
# Clone the repository
git clone https://github.com/devlimelabs/lulu-print-mcp.git
cd lulu-print-mcp
# Install dependencies
npm install
# Set up development environment
npm run setup:dev
# Start the development server
npm run dev
도커 설치
# Build and run with Docker Compose
docker-compose up -d
# Or build and run the Docker image directly
docker build -t lulu-print-mcp .
docker run -p 3000:3000 lulu-print-mcp
구성
1. Lulu API 자격 증명 받기
- https://developers.lulu.com/ 에서 Lulu 개발자 계정에 가입하세요
- 테스트를 위해 https://developers.sandbox.lulu.com/ 에서 샌드박스 계정을 만드세요.
- API 키 페이지로 이동하세요
- 클라이언트 키와 클라이언트 비밀번호를 복사하세요
2. 환경 변수 구성
# Create a configuration file
cp .env.example .env
Lulu API 자격 증명으로 .env 파일을 편집합니다.
# Required: Your Lulu API credentials
LULU_CLIENT_KEY=your_client_key_here
LULU_CLIENT_SECRET=your_client_secret_here
# Optional: API endpoints (defaults are provided)
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
# Use sandbox environment for testing (default: false)
LULU_USE_SANDBOX=false
# Enable debug logging (default: false)
DEBUG=false
Claude Desktop과 함께 사용
Claude Desktop 구성 파일에 이 MCP 서버를 추가하세요.
# Run the Claude Desktop setup script
npm run setup:claude
지침에 따라 Claude Desktop 구성 파일을 업데이트하세요. 스크립트는 다음과 유사한 구성을 생성합니다.
{
"mcpServers": {
"lulu-print": {
"command": "lulu-print-mcp",
"env": {
"LULU_CLIENT_KEY": "your_client_key",
"LULU_CLIENT_SECRET": "your_client_secret"
}
}
}
}
커서를 사용한 사용
커서 구성 파일에 이 MCP 서버를 추가합니다.
- 커서 설정 열기(
Cursor → Settings 또는 Mac에서는 Cmd+, ) - 기능 섹션으로 이동
- "모델 컨텍스트 프로토콜" 설정 찾기
- 다음 구성을 추가합니다.
{
"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"
}
}
}
}
또는 글로벌하게 설치된 경우:
{
"mcpServers": {
"lulu-print": {
"command": "lulu-print-mcp",
"env": {
"LULU_CLIENT_KEY": "your_client_key",
"LULU_CLIENT_SECRET": "your_client_secret"
}
}
}
}
Windsurf와 함께 사용
Windsurf 구성에 이 MCP 서버를 추가하세요:
- 프로젝트 디렉토리에서
.windsurf/config.json 파일을 생성하거나 편집하세요. - 다음 구성을 추가합니다.
{
"mcpServers": {
"lulu-print": {
"command": "lulu-print-mcp",
"env": {
"LULU_CLIENT_KEY": "your_client_key",
"LULU_CLIENT_SECRET": "your_client_secret"
}
}
}
}
Windsurf를 사용한 개발 설정:
{
"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
line_items: Array of items to price
- pod_package_id: Product SKU (e.g., "0600X0900BWSTDPB060UW444MXX")
- page_count: Number of pages
- quantity: Number of copies
shipping_address: Delivery address
- street1: Street address
- city: City name
- country_code: 2-letter ISO country code
- postcode: Postal code
- phone_number: Contact phone
shipping_option: MAIL | PRIORITY_MAIL | GROUND | EXPEDITED | EXPRESS
인쇄 작업 관리
인쇄 작업 생성
새로운 인쇄 작업 주문을 만듭니다.
create-print-job
line_items: Array of books to print
- title: Book title
- cover_url: URL to cover PDF
- interior_url: URL to interior PDF
- pod_package_id: Product SKU
- quantity: Number of copies
shipping_address: Delivery address
- name: Recipient name
- street1: Street address
- city: City
- country_code: 2-letter ISO code
- postcode: Postal code
- phone_number: Phone
contact_email: Email for order communication
shipping_level: MAIL | PRIORITY_MAIL | GROUND | EXPEDITED | EXPRESS
external_id: Your order reference (optional)
목록 인쇄 작업
선택적 필터를 사용하여 인쇄 작업 나열:
list-print-jobs
page: Page number (optional)
page_size: Results per page (optional)
status: Filter by status (optional)
created_after: Filter by creation date (optional)
created_before: Filter by creation date (optional)
인쇄 작업 가져오기
특정 인쇄 작업에 대한 세부 정보를 얻으세요:
get-print-job
id: Print job ID
업데이트-인쇄-작업
인쇄 작업 업데이트(결제 전에만):
update-print-job
id: Print job ID
external_id: New reference (optional)
contact_email: New email (optional)
인쇄 작업 취소
인쇄 작업 취소(미납인 경우에만):
cancel-print-job
id: Print job ID
인쇄 작업 상태 가져오기
인쇄 작업의 현재 상태를 가져옵니다.
get-print-job-status
id: Print job ID
인쇄 작업 비용 가져오기
인쇄 작업에 대한 자세한 비용을 알아보세요.
get-print-job-costs
id: Print job ID
인쇄 작업 통계 가져오기
특정 기간 동안의 인쇄 작업에 대한 통계를 얻으세요.
get-print-job-statistics
start_date: Start date (YYYY-MM-DD) (optional)
end_date: End date (YYYY-MM-DD) (optional)
group_by: DAY | WEEK | MONTH (optional)
파일 검증
내부 파일 검증
내부 PDF 파일 검증:
validate-interior-file
file_url: URL to interior PDF
pod_package_id: Product SKU (optional, for normalization)
내부 검증 받기
유효성 검사 상태 확인:
get-interior-validation
validation_id: ID from validate-interior-file
덮개 치수 계산
필요한 커버 치수를 계산하세요:
calculate-cover-dimensions
pod_package_id: Product SKU
page_count: Number of interior pages
unit: IN | MM | PT (optional, default: PT)
검증-커버-파일
표지 PDF 파일 검증:
validate-cover-file
file_url: URL to cover PDF
pod_package_id: Product SKU
page_count: Number of interior pages
커버 검증 받기
커버 유효성 검사 상태 확인:
get-cover-validation
validation_id: ID from validate-cover-file
해운
배송 옵션 받기
이용 가능한 배송 옵션을 확인하세요:
get-shipping-options
country_code: 2-letter ISO country code
state_code: State/province code (optional)
quantity: Number of items (optional)
pod_package_id: Product SKU (optional)
page_count: Number of pages (optional)
level: Filter by specific level (optional)
웹훅
웹훅 생성
웹훅 구독 만들기:
create-webhook
url: Webhook endpoint URL
topics: Array of events (currently supports ["PRINT_JOB_STATUS_CHANGED"])
웹훅 목록
모든 웹훅 구독 나열:
get-webhook
웹훅 세부 정보 받기:
get-webhook
id: Webhook ID
업데이트-웹훅
웹훅 업데이트:
update-webhook
id: Webhook ID
url: New URL (optional)
topics: New topics (optional)
is_active: Enable/disable (optional)
웹훅 삭제
웹훅 삭제:
delete-webhook
id: Webhook ID
테스트 웹훅
테스트 웹훅 보내기:
test-webhook
id: Webhook ID
topic: PRINT_JOB_STATUS_CHANGED
웹훅 제출 목록
웹훅 전달 시도 목록:
list-webhook-submissions
webhook_id: Filter by webhook (optional)
page: Page number (optional)
page_size: Results per page (optional)
Lulu 제품 SKU
Lulu는 27자로 구성된 SKU 시스템을 사용하여 제품을 식별합니다.
형식 : Trim Size + Color + Print Quality + Bind + Paper + PPI + Finish + Linen + Foil
일반적인 예
| 상품코드 | 설명 |
|---|
0850X1100BWSTDLW060UW444MNG | 네이비 리넨과 골드 호일이 들어간 8.5" x 11" 흑백 표준 리넨 랩 |
0600X0900FCSTDPB080CW444GXX | 광택 커버가 있는 6" x 9" 풀컬러 표준 페이퍼백 |
0700X1000FCPRECO060UC444MXX | 매트 커버가 있는 7" x 10" 풀컬러 프리미엄 코일 바인딩 |
0600X0900BWSTDPB060UW444MXX | 6" x 9" 흑백 표준 페이퍼백, 매트 커버 포함 |
Lulu 가격 계산기를 사용하여 귀하의 특정 요구 사항에 맞는 SKU를 생성하세요.
샌드박스로 테스트하기
테스트를 위해 Lulu 샌드박스 환경을 사용하려면:
- https://developers.sandbox.lulu.com/ 에서 샌드박스 계정을 만드세요
- 샌드박스 API 자격 증명을 받으세요
.env 파일에서 LULU_USE_SANDBOX=true 설정하세요.- 또는 CLI를 실행할 때
--sandbox 플래그를 사용하세요: lulu-print-mcp --sandbox
샌드박스 모드에서:
- 결제 시 테스트 신용 카드 번호를 사용하세요
- 주문은 실제 생산으로 전송되지 않습니다.
- 개발 및 테스트에 적합합니다
명령줄 옵션
lulu-print-mcp [options]
Options:
-s, --sandbox Use Lulu sandbox environment instead of production
-d, --debug Enable debug logging
-h, --help Display help
-V, --version Display version
문제 해결
인증 문제
- 클라이언트 키와 비밀번호가 올바른지 확인하세요.
- 올바른 환경(프로덕션 대 샌드박스)을 사용하고 있는지 확인하세요.
- API 자격 증명에 필요한 권한이 있는지 확인하세요.
파일 유효성 검사 오류
- URL을 통해 PDF 파일에 공개적으로 액세스할 수 있는지 확인하세요.
- Lulu 문서에서 파일 형식 요구 사항을 확인하세요.
- 페이지 수와 치수가 제품 사양과 일치하는지 확인하세요.
네트워크 문제
- 인터넷 연결을 확인하세요
- 방화벽 설정이 api.lulu.com에 대한 HTTPS 연결을 허용하는지 확인하세요.
- 자세한 요청/응답 로그를 보려면 디버그 모드를 활성화하세요.
기여하다
기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.
특허
MIT