ShopOps MCP

Сервер на базе ИИ, реализующий протокол Model Context Protocol (MCP) для управления магазинами на Shopify и WooCommerce.

Функции

Коннекторы магазинов для Shopify и WooCommerce.
11 инструментов MCP, охватывающих запасы, ценообразование, клиентов, заказы, эффективность продуктов и отчетность.
4 ресурса MCP, предоставляющих обзор магазина, запасы, последние заказы и топ клиентов.
Прогнозирование запасов с использованием скользящего среднего спроса и расчета страхового запаса.
RFM-сегментация клиентов (7 различных сегментов).
Анализ и оптимизация ценообразования на основе ИИ.
Обнаружение аномалий / мошенничества в заказах.
ABC-анализ эффективности продуктов.
Автоматизированные ежедневные и еженедельные отчеты.
Двойной транспорт: локальный stdio и Streamable HTTP (MCPize).
TypeScript, @modelcontextprotocol/sdk v1.29+, Zod v4.
Бесплатный тариф, а также платные планы за $25 и $45.

Быстрый старт

# 1. Install the package
npm i shopops-mcp

# 2. Create a .env file (see Configuration section)
cp .env.example .env

# 3. Run the server (local stdio mode)
npx shopops-mcp run --transport stdio

# 4. Or start the HTTP endpoint (MCPize deployment)
npx shopops-mcp run --transport http --port 8080

Сервер считает переменные окружения, подключится к настроенному магазину (магазинам) и предоставит инструменты и ресурсы MCP.

Инструменты MCP

Инструмент	Описание
`store_connect`	Устанавливает соединение с магазином Shopify или WooCommerce и проверяет учетные данные.
`inventory_status`	Возвращает текущие уровни запасов, флаги отложенных заказов и оповещения о низком уровне запасов.
`inventory_forecast`	Прогнозирует будущие потребности в запасах, используя скользящее среднее спроса и буферы страхового запаса.
`pricing_analyze`	Генерирует отчет об эластичности цен и определяет товары с заниженными/завышенными ценами.
`pricing_optimize`	Предлагает оптимальные цены на основе прогнозов спроса от ИИ и данных конкурентов.
`customers_segment`	Выполняет RFM-анализ и распределяет клиентов по одному из семи сегментов.
`customers_churn`	Оценивает риск оттока клиентов и предоставляет рекомендации по удержанию.
`order_anomalies`	Обнаруживает потенциально мошеннические или ошибочные заказы с помощью моделей распознавания образов.
`product_performance`	Проводит ABC-анализ и возвращает метрики вклада по классам продуктов.
`report_daily`	Генерирует ежедневную сводку операций в формате JSON/CSV (продажи, запасы, оповещения).
`report_weekly`	Генерирует еженедельный отчет об эффективности с визуализацией трендов.

Ресурсы MCP

Ресурс	Описание
`store://overview`	Метрики магазина высокого уровня: общие продажи, заказы, клиенты и валовая прибыль.
`store://inventory`	Полный каталог запасов с количеством в наличии, зарезервированными запасами и прогнозируемым дефицитом.
`store://orders/recent`	Список из 100 последних заказов со статусом, общей стоимостью и способом оплаты.
`store://customers/top`	Топ-50 клиентов, ранжированных по пожизненной ценности (LTV), частоте покупок и давности.

Конфигурация

Создайте файл .env в корне проекта. Требуются следующие переменные:

Переменная	Требуется для	Описание
`SHOPIFY_API_KEY`	Shopify	API-ключ частного приложения.
`SHOPIFY_API_PASSWORD`	Shopify	Пароль частного приложения.
`SHOPIFY_STORE_DOMAIN`	Shopify	Домен магазина (например, `myshop.myshopify.com`).
`WOOCOMMERCE_CONSUMER_KEY`	WooCommerce	Ключ потребителя REST API.
`WOOCOMMERCE_CONSUMER_SECRET`	WooCommerce	Секрет потребителя REST API.
`WOOCOMMERCE_STORE_URL`	WooCommerce	URL магазина (например, `https://example.com`).
`MCP_PORT`	HTTP-транспорт	Порт для конечной точки Streamable HTTP (по умолчанию `8080`).
`MCP_LOG_LEVEL`	Все	Уровень детализации логирования (`error`, `warn`, `info`, `debug`).
`MCP_PRICING_MODEL`	Инструменты ценообразования	Выбор модели ценообразования (`basic`, `advanced`).
`MCP_FORECAST_WINDOW_DAYS`	Прогноз запасов	Количество дней для прогнозирования (по умолчанию `30`).

Дополнительные переменные:

Переменная	Описание
`MCP_ENABLE_ANONYMIZATION`	Если установлено значение `true`, персональные данные маскируются в отчетах.
`MCP_REPORT_S3_BUCKET`	Если указано, ежедневные/еженедельные отчеты загружаются в указанный бакет S3.

Лицензия

ShopOps MCP выпущено под лицензией MIT. Полные условия см. в файле LICENSE.

Автор: Automatia BCN

shopops-mcp