Сервер 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"])
список-вебхуков
Список всех подписок на веб-перехватчики:
получить-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.
- Включите режим отладки, чтобы увидеть подробные журналы запросов/ответов.
Внося вклад
Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.
Лицензия
Массачусетский технологический институт