Skip to main content
Glama
Pyro Storefront MCP Server
by pyroua

Pyro Storefront MCP Server 🎆

npm version Model Context Protocol License: MIT

Офіційний клієнтський MCP-сервер (Model Context Protocol) для інтернет-магазину піротехніки та салютів pyro.ua.

Дозволяє автономним ІІ-агентам (Claude Desktop, Cursor, Cline, Windsurf, ChatGPT Desktop) підбирати феєрверки за технічними характеристиками (калібр, кількість пострілів, тривалість, бюджет), перевіряти складські залишки, знаходити найближчі відділення і поштомати Нової Пошти та безпечно оформляти замовлення з миттєвим онлайн-чекаутом через Monobank.


⚡ Швидке підключення (1-Click Run)

Сервер повністю автономний, зібраний у єдиний виконуваний бандл і не потребує ручного встановлення залежностей.

🟣 1. Claude Desktop

Додайте в конфігураційний файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pyro-storefront": {
      "command": "npx",
      "args": ["-y", "github:pyroua/pyro-storefront-mcp"]
    }
  }
}

🔵 2. Cursor / Windsurf

Додайте в .cursor/mcp.json:

{
  "mcpServers": {
    "pyro-storefront": {
      "command": "npx",
      "args": ["-y", "github:pyroua/pyro-storefront-mcp"]
    }
  }
}

Related MCP server: Commerce MCP Server

🛠️ Доступні інструменти (Tools)

Інструмент

Опис

search_fireworks

Пошук піротехніки за бюджетом, калібром (мм), кількістю пострілів та ключовими словами

get_firework_details

Детальні ТТХ товару: опис, фото, відео роботи, безпечна дистанція, інструкція

check_stock_availability

Пакетна перевірка залишків на складі та розрахунок підсумкової вартості

search_delivery_branches

Пошук відділень і поштоматів Нової Пошти в обраному місті України

create_order

Оформлення роздрібного замовлення з генерацією захищеного посилання на оплату Monobank

track_order

Перевірка статусу замовлення та ТТН за номером замовлення та 4 останніми цифрами телефону


💬 Приклади запитів для вашого AI-асистента

  • «Підбери салют на день народження до 3500 грн, від 30 мм калібру, не менше ніж на 30 пострілів. Покажи відео та ціну.»

  • «Знайди поштомати Нової Пошти у Києві біля станції метро Мінська.»

  • «Оформи замовлення на салют №508 на ім'я Ігор Шульга (+380501234567) з доставкою до поштомату №1263 у Києві. Мені є 18 років.»

  • «Який статус мого замовлення №72901? Мій номер закінчується на 4567.»


🛡️ Безпека та захист даних (Enterprise Gold Standard)

  1. DLP & Нульовий витік комерційної таємниці: Сервер має сувору ізоляцію від внутрішніх систем. Собівартість, маржа та дані постачальників недоступні клієнтському MCP.

  2. Захист від перебору (Anti-Enumeration): Метод track_order вимагає обов'язкового збігу останніх 4 цифр телефону. Номери телефонів у відповідях маскуються (+380 50 *** ** 67).

  3. Age Gate (18+): Замовлення створюються виключно за умови явної підтвердженої згоди клієнта про досягнення повноліття (confirmed_legal_age: true).

  4. Ідемпотентність: Запобігання повторним списанням та дублюванню замовлень завдяки Idempotency-Key.


💻 Локальна розробка

# Клонування репозиторію
git clone https://github.com/pyroua/pyro-storefront-mcp.git
cd pyro-storefront-mcp

# Встановлення залежностей
npm install

# Збірка самодостатнього бандла
npm run bundle

# Локальний запуск
node dist/index.js

📄 Ліцензія

MIT License © 2026 IT1.TEAM / pyro.ua. Всі права захищені.

Available Tools

6 tools
check_stock_availabilityA

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

Inputs: items (required).

create_orderC

Оформление заказа в pyro.ua с мгновенной ссылкой на оплату картой (Monobank) или наложенным платежом

Inputs: city (required), phone (required), last_name (required), cart_items (required), +10 more.

get_firework_detailsA

Получить полные характеристики салюта (калибр, видео работы, время, безопасная дистанция, инструкция)

Inputs: product_id (required).

search_delivery_branchesA

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

Inputs: city_name (required), branch_type.

search_fireworksB

Поиск пиротехники и салютов в каталоге pyro.ua по бюджету, калибру, количеству залпов и времени работы

Inputs: q, page, limit, caliber, +5 more.

track_orderA

Отслеживание статуса готовности заказа и номера ТТН Новой Почты с защитой от перебора (DLP)

Inputs: order_id (required), phone_last4 (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool maps to a distinct stage or resource: catalogue search, item details, stock validation, delivery branch lookup, order creation, and order tracking. The only potential overlap is between search_fireworks and get_firework_details, but their purpose is clearly separated by list-level vs. detail-level access.

    Naming Consistency5/5

    All tools follow a consistent verb_noun snake_case pattern: get_, search_, check_, track_, create_. This makes the toolset predictable and easy to reason about, with no mixed conventions or vague generic verbs.

    Tool Count5/5

    Six tools is well-scoped for a storefront server: search, details, stock, delivery, ordering, and tracking each earn their place. The surface is neither bloated nor too thin for the stated purpose.

    Completeness4/5

    The core customer journey is covered end-to-end: find products, inspect them, verify stock, choose a delivery branch, place an order, and track it. Minor gaps exist such as no explicit order details endpoint or cancellation flow, but agents can complete the main purchase workflow without dead ends.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers