Skip to main content
Glama
deenesjakoruzh
devlimelabs

Lulu Print MCP Server

by devlimelabs
OverviewInspectSchemaRelated ServersScoreDiscussions
TypeScript
Remote

Сервер MCP Lulu Print

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

Функции

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

  • Создавайте и управляйте заданиями на печать книг и других печатных материалов

  • Отслеживайте статус заказа от создания до доставки

  • Рассчитайте стоимость перед размещением заказов

  • Поддержка нескольких позиций в заказе

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

  • Проверьте внутренние файлы PDF перед печатью

  • Проверка файлов PDF обложек с проверкой размеров

  • Рассчитайте необходимые размеры обложки на основе количества страниц

  • Получите подробный статус проверки и отчеты об ошибках

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

  • Рассчитать себестоимость продукции на основе спецификаций

  • Включить расчеты стоимости доставки и налогов

  • Поддержка различных уровней доставки (от MAIL до EXPRESS)

  • Получите подробную разбивку затрат

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

  • Получить доступные варианты доставки по месту назначения

  • Поддержка международной доставки

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

🔔 Вебхуки

  • Подпишитесь на обновления статуса задания на печать

  • Управление конечными точками веб-перехвата

  • Тестовая доставка вебхука

  • Просмотреть историю отправки вебхуков

Related MCP server: Fused MCP Agents

Установка

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

# 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

  1. Зарегистрируйте учетную запись разработчика Lulu на сайте https://developers.lulu.com/

  2. Для тестирования создайте учетную запись sandbox на сайте https://developers.sandbox.lulu.com/

  3. Перейдите на страницу ключей API.

  4. Скопируйте свой клиентский ключ и секретный ключ клиента

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-сервер в файл конфигурации курсора:

  1. Откройте настройки курсора ( Cursor → Settings или Cmd+, на Mac)

  2. Перейдите в раздел «Функции».

  3. Найдите настройки «Model Context Protocol»

  4. Добавьте следующую конфигурацию:

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

  1. Создайте или отредактируйте файл .windsurf/config.json в каталоге вашего проекта.

  2. Добавьте следующую конфигурацию:

{ "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 для тестирования:

  1. Создайте учетную запись sandbox на сайте https://developers.sandbox.lulu.com/

  2. Получите учетные данные API вашей песочницы

  3. Установите LULU_USE_SANDBOX=true в вашем .env файле

  4. Или используйте флаг --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.

  • Включите режим отладки, чтобы увидеть подробные журналы запросов/ответов.

Внося вклад

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

Лицензия

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

One-click Deploy
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/devlimelabs/lulu-print-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server