Сервер MCP Lulu Print

Integrations

Used for environment variable configuration to store Lulu API credentials and other settings
Provides containerized deployment of the Lulu Print MCP server through Docker and Docker Compose
Repository hosting for the Lulu Print MCP code, allowing cloning for local development

Сервер MCP Lulu Print

Сервер Model Context Protocol (MCP), который обеспечивает интеграцию с API Lulu Print для услуг печати по запросу через Claude Desktop и другие клиенты MCP.

Функции

📚 Управление заданиями печати

Создавайте и управляйте заданиями на печать книг и других печатных материалов
Отслеживайте статус заказа от создания до доставки
Рассчитайте стоимость перед размещением заказов
Поддержка нескольких позиций в заказе

📄 Проверка файла

Проверьте внутренние файлы PDF перед печатью
Проверка файлов PDF обложек с проверкой размеров
Рассчитайте необходимые размеры обложки на основе количества страниц
Получите подробный статус проверки и отчеты об ошибках

💰 Расчет стоимости

Рассчитать себестоимость продукции на основе спецификаций
Включить расчеты стоимости доставки и налогов
Поддержка различных уровней доставки (от MAIL до EXPRESS)
Получите подробную разбивку затрат

🚚 Управление доставкой

Получить доступные варианты доставки по месту назначения
Поддержка международной доставки
Различные уровни обслуживания: от стандартной почты до экспресс-доставки

🔔 Вебхуки

Подпишитесь на обновления статуса задания на печать
Управление конечными точками веб-перехвата
Тестовая доставка вебхука
Просмотреть историю отправки вебхуков

Установка

Глобальная установка

# Install the package globally
npm install -g @devlimelabs/lulu-print-mcp

# Start the server
lulu-print-mcp

Местное развитие

# 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. Получите учетные данные API Lulu

Зарегистрируйте учетную запись разработчика Lulu на сайте https://developers.lulu.com/
Для тестирования создайте учетную запись sandbox на сайте https://developers.sandbox.lulu.com/
Перейдите на страницу ключей API.
Скопируйте свой клиентский ключ и секретный ключ клиента

2. Настройте переменные среды

# Create a configuration file
cp .env.example .env

Отредактируйте файл .env , используя ваши учетные данные API Lulu:

# 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

Добавьте этот сервер MCP в файл конфигурации Claude Desktop:

# 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 или Cmd+, на Mac)
Перейдите в раздел «Функции».
Найдите настройки «Model Context Protocol»
Добавьте следующую конфигурацию:

{
  "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"
      }
    }
  }
}

Использование с виндсерфингом

Добавьте этот сервер MCP в конфигурацию Windsurf:

Создайте или отредактируйте файл .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"])

список-вебхуков

Список всех подписок на веб-перехватчики:

list-webhooks

получить-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

список-webhook-отчетов

Список попыток доставки вебхука:

list-webhook-submissions
  webhook_id: Filter by webhook (optional)
  page: Page number (optional)
  page_size: Results per page (optional)

Артикулы продукции Lulu

Для идентификации продукции Lulu использует 27-символьную систему артикулов:

Формат : 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 для расчета артикулов, соответствующих вашим конкретным потребностям.

Тестирование с помощью песочницы

Чтобы использовать среду песочницы Lulu для тестирования:

Создайте учетную запись sandbox на сайте https://developers.sandbox.lulu.com/
Получите учетные данные API вашей песочницы
Установите LULU_USE_SANDBOX=true в вашем .env файле
Или используйте флаг --sandbox при запуске CLI: 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 имеют необходимые разрешения.

Ошибки проверки файла

Обеспечьте публичный доступ к файлам PDF через URL
Проверьте требования к формату файла в документации Lulu.
Проверьте, соответствуют ли количество страниц и размеры спецификациям продукта.

Проблемы с сетью

Проверьте подключение к Интернету
Убедитесь, что настройки брандмауэра разрешают HTTPS-подключения к api.lulu.com.
Включите режим отладки, чтобы увидеть подробные журналы запросов/ответов.

Внося вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.

Лицензия

Массачусетский технологический институт

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Обеспечивает интеграцию с API Lulu Print для услуг печати по запросу через Claude Desktop и другие клиенты MCP, позволяя пользователям создавать и управлять заданиями печати, проверять файлы, рассчитывать стоимость и управлять доставкой книг и печатных материалов.

Related MCP Servers

MCP 3D Printer Server
DMontgomery40
A
security
A
license
A
quality
Enables interaction with 3D printer management systems through an MCP server, supporting STL file manipulation, slicing, and control of printers like OctoPrint, Klipper, Duet, and more.
Last updated -
11
33
48
TypeScript
GPL 2.0
Shopify Python MCP Server
kishimoto-banana
A
security
A
license
A
quality
MCP server that integrates with Shopify API, allowing Claude Desktop users to retrieve and manipulate product information from Shopify stores.
Last updated -
5
Python
MIT License
Inkdrop MCP Serverofficial
inkdropapp
A
security
A
license
A
quality
Integrates Inkdrop note-taking app with Claude AI through Model Context Protocol, allowing Claude to search, read, create, and update notes in your Inkdrop database.
Last updated -
5
58
16
JavaScript
Apache 2.0
Autumn MCP Server
SirTenzin
-
security
A
license
-
quality
An unofficial MCP server that provides an interface to access the Autumn pricing API for managing customers, entitlements, invoices, and generating billing portal links.
Last updated -
5
TypeScript
MIT License

View all related MCP servers