npm - suare-mcp - Versions diffs - 1.0.0 - Mend

suare-mcp 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/.env.example ADDED Viewed

@@ -0,0 +1,13 @@
+# SUARE MCP Server Environment Configuration (.env.example)
+# URL бэкенд API SUARE
+SUARE_API_URL="https://suare-server.vercel.app"
+# Публичный URL клиентского сайта SUARE
+SUARE_WEB_URL="https://suaree.vercel.app"
+# Порт для запуска HTTP/SSE сервера (для ChatGPT Actions и n8n)
+PORT=3800
+# Режим транспорта: "stdio" (по умолчанию для IDE) или "http"
+MCP_TRANSPORT="stdio"

package/.env.production ADDED Viewed

@@ -0,0 +1,5 @@
+# SUARE MCP Server Production Environment Variables (.env.production)
+SUARE_API_URL="https://suare-server.vercel.app"
+SUARE_WEB_URL="https://suaree.vercel.app"
+PORT=3800
+MCP_TRANSPORT="http"

package/README.md ADDED Viewed

@@ -0,0 +1,99 @@
+# SUARE MCP Server (Model Context Protocol)
+> **Назначение:** Позволяет ИИ-моделям (**ChatGPT, Claude, Antigravity IDE, Cursor, n8n**) быстро создавать цифровые пригласительные на тои и свадьбы в SUARE (`suare.app`), управлять деталями торжества, настраивать списки гостей и получать прямые ссылки на превью и оплату прямо из чата.
+---
+## 1. Доступные инструменты (Tools)
+| Инструмент | Описание |
+|---|---|
+| `suare_list_templates` | Возвращает каталог шаблонов (40+ дизайнов) с фильтрацией по категориям (Свадьба, Қыз ұзату, Сүндет той, Тұсау кесер, Мерейтой) и точной стоимостью напрямую из базы данных. |
+| `suare_create_invitation` | Создает цифровое пригласительное по данным из диалога. Генерирует ссылку для гостей (`suare.app/i/slug`), ссылку на конструктор, превью-карточку, стоимость из БД и готовый текст для WhatsApp. |
+| `suare_get_invitation` | Возвращает данные пригласительного и статус подтверждений гостей (RSVP). |
+| `suare_update_invitation` | Вносит изменения в дату, зал, имена, дресс-код или меняет шаблон оформления. |
+| `suare_manage_guests` | Добавление гостей текстом или массивом, получение структуры для массового импорта через Excel. |
+| `suare_get_payment_info` | Возвращает точную сумму из базы данных, прямую ссылку на оплату без регистрации (`suare.app/pay/editToken`) и реквизиты Kaspi Pay / QR. |
+---
+## 2. Подключение к ИИ-клиентам
+### Вариант А: Antigravity IDE (Уже подключено!)
+В файле `~/.gemini/config/mcp_config.json`:
+```json
+{
+  "mcpServers": {
+    "suare": {
+      "command": "node",
+      "args": ["c:\\Users\\Akim.O\\Documents\\Личные\\проект\\suare new\\suare-mcp\\index.js"],
+      "env": {
+        "SUARE_API_URL": "http://localhost:4000",
+        "SUARE_WEB_URL": "https://suare.app"
+      }
+    }
+  }
+}
+```
+---
+### Вариант Б: Claude Desktop
+Откройте файл конфигурации Claude Desktop:
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+Добавьте секцию `mcpServers`:
+```json
+{
+  "mcpServers": {
+    "suare": {
+      "command": "node",
+      "args": ["c:\\Users\\Akim.O\\Documents\\Личные\\проект\\suare new\\suare-mcp\\index.js"],
+      "env": {
+        "SUARE_WEB_URL": "https://suare.app"
+      }
+    }
+  }
+}
+```
+Перезапустите Claude Desktop — в меню появится значок молоточка с инструментами `suare_*`.
+---
+### Вариант В: ChatGPT (Custom GPT Store / Actions)
+Для использования в ChatGPT:
+1. Запустите HTTP-режим:
+   ```bash
+   npm run start:http
+   # Сервер запустится на http://localhost:3800
+   ```
+2. Откройте [chatgpt.com/gpts/editor](https://chatgpt.com/gpts/editor) (GPT Builder).
+3. Во вкладке **Configure** укажите:
+   - **Name:** SUARE — Онлайн-шақыру жасау
+   - **Description:** ИИ-помощник для создания стильных свадебных онлайн-пригласительных за 2 минуты.
+   - **Instructions:**
+     ```text
+     Ты — официальный ИИ-ассистент платформы SUARE (suare.app).
+     Помогай пользователям создавать цифровые пригласительные на тои, свадьбы, қыз ұзату, сүндет той и юбилеи в Казахстане.
+     Общайся вежливо на казахском или русском языке.
+     Спрашивай имена главных героев, дату, ресторан/зал и тип тоя.
+     Вызывай действие createInvitation и отправляй пользователю превью-карточку, ссылку для гостей и текст для WhatsApp!
+     ```
+4. В разделе **Actions** нажмите **Create new action** и вставьте содержимое файла:
+   `suare-mcp/openapi.json`.
+5. Готово! Пользователи могут писать боту прямо в ChatGPT на телефоне или компьютере.
+---
+### Вариант Г: n8n (AI Agent Node)
+В n8n подключите ноду **AI Agent** и добавьте инструмент **Custom MCP Tool**, указав URL:
+`http://localhost:3800/mcp` или прямой Webhook.
+---
+## 3. Проверка работоспособности
+```bash
+node test-client.js
+```
+Выведет `✅ All MCP JSON-RPC 2.0 tests passed successfully!`.

package/index.js ADDED Viewed

@@ -0,0 +1,890 @@
+#!/usr/bin/env node
+// ==============================================================================
+// SUARE MCP SERVER (Model Context Protocol)
+// Provides tools for LLMs (ChatGPT, Claude, Antigravity) to browse templates,
+// create digital event invitations, manage guest lists, and handle RSVPs directly from chat.
+//
+// Transports:
+//   1. Stdio (Standard Input/Output) - for Claude Desktop, Antigravity IDE, Cursor
+//   2. HTTP / SSE - for remote clients, ChatGPT Developer Mode, n8n, webhooks
+// ==============================================================================
+const fs = require("fs");
+const path = require("path");
+const http = require("http");
+const readline = require("readline");
+// Configuration
+const SUARE_API_URL = process.env.SUARE_API_URL || "https://suare-server.vercel.app";
+const SUARE_WEB_URL = process.env.SUARE_WEB_URL || "https://suaree.vercel.app";
+const HTTP_PORT = parseInt(process.env.PORT || "3800", 10);
+const IS_HTTP_MODE = process.argv.includes("--http") || process.env.MCP_TRANSPORT === "http";
+// Local in-memory invitation registry (persisted or synchronized with backend)
+const memoryStore = new Map();
+// Helper: Slugify names
+function slugify(text) {
+  const ruMap = {
+    а: "a", б: "b", в: "v", г: "g", д: "d", е: "e", ё: "yo", ж: "zh",
+    з: "z", и: "i", й: "y", к: "k", л: "l", м: "m", н: "n", о: "o",
+    п: "p", р: "r", с: "s", т: "t", у: "u", ф: "f", х: "kh", ц: "ts",
+    ч: "ch", ш: "sh", щ: "shch", ъ: "", ы: "y", ь: "", э: "e", ю: "yu", я: "ya",
+    ә: "a", ғ: "g", қ: "q", ң: "n", ө: "o", ұ: "u", ү: "u", һ: "h", і: "i",
+    " ": "-", "&": "and", "+": "and",
+  };
+  return text
+    .toLowerCase()
+    .split("")
+    .map((c) => (ruMap[c] !== undefined ? ruMap[c] : c))
+    .join("")
+    .replace(/[^a-z0-9-]/g, "")
+    .replace(/-+/g, "-")
+    .replace(/^-|-$/g, "");
+}
+// ==============================================================================
+// 1. DYNAMIC TEMPLATES CATALOG (Loaded from database / generated json)
+// ==============================================================================
+const generatedFile = path.join(__dirname, "..", "suare-server", "prisma", "templates.generated.json");
+function getTemplates() {
+  if (fs.existsSync(generatedFile)) {
+    try {
+      const raw = JSON.parse(fs.readFileSync(generatedFile, "utf8"));
+      return raw.map((t) => ({
+        slug: t.slug,
+        nameRu: t.nameRu || t.nameKk,
+        nameKk: t.nameKk || t.nameRu,
+        descriptionRu: t.descriptionRu || "",
+        descriptionKk: t.descriptionKk || "",
+        categories: t.categories || ["WEDDING"],
+        priceTenge: typeof t.priceTenge === "number" ? t.priceTenge : 0,
+        tags: t.tags || ["animated"],
+        previewUrl: `${SUARE_WEB_URL}/templates/${t.slug}.png`,
+      }));
+    } catch (e) {
+      console.warn("Could not parse templates.generated.json, using fallback");
+    }
+  }
+  return FALLBACK_TEMPLATES;
+}
+function getTemplateBySlug(slug) {
+  const all = getTemplates();
+  return all.find((t) => t.slug === slug) || null;
+}
+const FALLBACK_TEMPLATES = [
+    {
+      slug: "altyn-oyu",
+      nameRu: "Золотой орнамент (Алтын ою)",
+      nameKk: "Алтын ою",
+      descriptionRu: "Премиальный темный оникс с благородным золотым казахским орнаментом и золотыми искрами.",
+      categories: ["WEDDING", "ANNIVERSARY"],
+      priceTenge: 5990,
+      tags: ["dark", "national", "gold", "animated"],
+      previewUrl: `${SUARE_WEB_URL}/templates/altyn-oyu.png`,
+    },
+    {
+      slug: "aru-qyz",
+      nameRu: "Ару қыз",
+      nameKk: "Ару қыз",
+      descriptionRu: "Нежный пудровый стиль с акварельными цветами и плавной анимацией для проводов невесты.",
+      categories: ["KYZ_UZATU", "WEDDING"],
+      priceTenge: 3990,
+      tags: ["light", "romantic", "floral", "animated"],
+      previewUrl: `${SUARE_WEB_URL}/templates/aru-qyz.png`,
+    },
+    {
+      slug: "saltanat-kesh",
+      nameRu: "Торжественный вечер (Салтанат кеші)",
+      nameKk: "Салтанат кеші",
+      descriptionRu: "Вечерний глубокий стиль с акцентом на фотосессию Love Story и мерцающие золотые огни.",
+      categories: ["WEDDING", "ANNIVERSARY"],
+      priceTenge: 5990,
+      tags: ["dark", "photo", "luxury", "animated"],
+      previewUrl: `${SUARE_WEB_URL}/templates/saltanat-kesh.png`,
+    },
+    {
+      slug: "batyr-tulpar",
+      nameRu: "Батыр тұлпар",
+      nameKk: "Батыр тұлпар",
+      descriptionRu: "Торжественный национальный стиль с крылатым скакуном и традиционными узорами для сүндет тоя.",
+      categories: ["SUNDET_TOI"],
+      priceTenge: 3990,
+      tags: ["light", "national", "kids", "animated"],
+      previewUrl: `${SUARE_WEB_URL}/templates/batyr-tulpar.png`,
+    },
+    {
+      slug: "algashqy-qadam",
+      nameRu: "Алғашқы қадам (Первые шаги)",
+      nameKk: "Алғашқы қадам",
+      descriptionRu: "Светлый и трогательный дизайн с белой дорожкой и традиционным ала жіп для тұсау кесер.",
+      categories: ["TUSAU_KESER"],
+      priceTenge: 3990,
+      tags: ["light", "kids", "animated"],
+      previewUrl: `${SUARE_WEB_URL}/templates/algashqy-qadam.png`,
+    },
+    {
+      slug: "altyn-zhas",
+      nameRu: "Золотой юбилей (Алтын жас)",
+      nameKk: "Алтын жас",
+      descriptionRu: "Солидный изумрудно-золотой дизайн для уважаемых юбиляров (50, 60, 70 лет).",
+      categories: ["ANNIVERSARY", "JUBILEE"],
+      priceTenge: 5990,
+      tags: ["dark", "gold", "prestige", "animated"],
+      previewUrl: `${SUARE_WEB_URL}/templates/altyn-zhas.png`,
+    },
+  ];
+const CATEGORY_NAMES = {
+  WEDDING: { titleRu: "Үйлену той (Свадьба)", titleKk: "Үйлену тойы", emoji: "👰🤵" },
+  KYZ_UZATU: { titleRu: "Қыз ұзату (Проводы невесты)", titleKk: "Қыз ұзату", emoji: "🌸" },
+  SUNDET_TOI: { titleRu: "Сүндет той", titleKk: "Сүндет тойы", emoji: "🐎" },
+  SUNDET_TOY: { titleRu: "Сүндет той", titleKk: "Сүндет тойы", emoji: "🐎" },
+  TUSAU_KESER: { titleRu: "Тұсау кесер", titleKk: "Тұсау кесер", emoji: "👣" },
+  BESIK_TOI: { titleRu: "Бесік той", titleKk: "Бесік тойы", emoji: "👶" },
+  SHILDEKHANA: { titleRu: "Шілдехана", titleKk: "Шілдехана", emoji: "🍼" },
+  QYRQYNAN: { titleRu: "Қырқынан шығару", titleKk: "Қырқынан шығару", emoji: "✨" },
+  TILASHAR: { titleRu: "Тілашар", titleKk: "Тілашар", emoji: "🎒" },
+  ANNIVERSARY: { titleRu: "Мерейтой / Юбилей", titleKk: "Мерейтой", emoji: "🎂" },
+  JUBILEE: { titleRu: "Мерейтой / Юбилей", titleKk: "Мерейтой", emoji: "🎂" },
+  BIRTHDAY: { titleRu: "Туған күн (День рождения)", titleKk: "Туған күн", emoji: "🎉" },
+  QONYS_TOI: { titleRu: "Қоныс той (Новоселье)", titleKk: "Қоныс той", emoji: "🏡" },
+  AUYZASHAR: { titleRu: "Ауызашар", titleKk: "Ауызашар", emoji: "🌙" },
+  CORPORATE: { titleRu: "Корпоратив", titleKk: "Корпоратив", emoji: "💼" },
+  GATHERING: { titleRu: "Бас қосу / Қонақасы", titleKk: "Бас қосу", emoji: "☕" },
+};
+// ==============================================================================
+// 2. TOOLS DEFINITION (MCP SPECIFICATION)
+// ==============================================================================
+const TOOLS = [
+  {
+    name: "suare_list_templates",
+    description:
+      "Возвращает структурированный каталог дизайнерских шаблонов SUARE (40+ шаблонов), сгруппированных по категориям тоев (Үйлену той, Қыз ұзату, Сүндет той, Тұсау кесер, Мерейтой, Бесік той, Қоныс той и др.) с актуальной стоимостью из базы данных, стилями и живыми демо-ссылками. Используйте этот инструмент, когда пользователь выбирает дизайн или спрашивает, какие шаблоны есть.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        category: {
+          type: "string",
+          description:
+            "Категория торжества для фильтрации (ALL, WEDDING, KYZ_UZATU, SUNDET_TOI, TUSAU_KESER, BESIK_TOI, ANNIVERSARY, BIRTHDAY, QONYS_TOI, AUYZASHAR, CORPORATE, TILASHAR, SHILDEKHANA, QYRQYNAN, GATHERING)",
+          default: "ALL",
+        },
+        style: {
+          type: "string",
+          enum: ["ALL", "national", "gold", "dark", "light", "minimal", "floral", "photo"],
+          description: "Желаемый стиль оформления (national - казахский орнамент, gold - золото, dark - ночной премиум, light - светлый, floral - акварель/цветы, photo - с фотосессией)",
+          default: "ALL",
+        },
+      },
+    },
+  },
+  {
+    name: "suare_create_invitation",
+    description:
+      "Создает новое онлайн-пригласительное в SUARE по данным из диалога. Возвращает готовую ссылку для гостей (suare.app/i/slug), ссылку на конструктор, карточку-превью и текст для отправки в WhatsApp.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        type: {
+          type: "string",
+          enum: ["WEDDING", "QYZ_UZATU", "SUNDET_TOY", "JUBILEE", "BIRTHDAY"],
+          description: "Тип мероприятия (напр. WEDDING для свадьбы, QYZ_UZATU для проводов)",
+        },
+        hostNames: {
+          type: "string",
+          description: "Имена главных героев (напр. 'Азамат & Аружан', 'Алихан')",
+        },
+        organizers: {
+          type: "string",
+          description: "Той иелері / Организаторы (напр. 'Марат - Гүлнар', 'Ата-анасы')",
+        },
+        startsAt: {
+          type: "string",
+          description: "Дата и время в формате ISO или YYYY-MM-DD HH:mm (напр. '2026-08-15 18:00')",
+        },
+        venueName: {
+          type: "string",
+          description: "Название банкетного зала или ресторана (напр. 'Ritz-Carlton Almaty', 'Салтанат Сарайы')",
+        },
+        venueAddress: {
+          type: "string",
+          description: "Адрес проведения (город, улица)",
+        },
+        venueMapUrl: {
+          type: "string",
+          description: "Ссылка на 2GIS или Яндекс.Карты (опционально)",
+        },
+        templateSlug: {
+          type: "string",
+          description: "Slug выбранного шаблона (altyn-orda, minimal-rose, classic-gold и др.)",
+        },
+        dressCode: {
+          type: "string",
+          description: "Пожелания по нарядам гостей (напр. 'Black Tie', 'Пастельные тона')",
+        },
+        customSlug: {
+          type: "string",
+          description: "Желаемый красивый URL адрес (напр. 'azamat-aruzhan')",
+        },
+        program: {
+          type: "array",
+          description: "Таймлайн программы вечера",
+          items: {
+            type: "object",
+            properties: {
+              time: { type: "string", description: "Время (напр. '18:00')" },
+              title: { type: "string", description: "Событие (напр. 'Сбор гостей', 'Беташар')" },
+            },
+            required: ["time", "title"],
+          },
+        },
+      },
+      required: ["type", "hostNames", "startsAt", "venueName"],
+    },
+  },
+  {
+    name: "suare_get_invitation",
+    description:
+      "Получает информацию об уже созданном пригласительном, статус RSVP (список подтвердивших гостей, количество взрослых и детей).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        slug: {
+          type: "string",
+          description: "Короткий адрес пригласительного (напр. 'azamat-aruzhan')",
+        },
+      },
+      required: ["slug"],
+    },
+  },
+  {
+    name: "suare_update_invitation",
+    description:
+      "Вносит изменения в уже созданное пригласительное по его slug или editToken: изменение зала, даты, имен, программы, дресс-кода или смена шаблона оформления.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        slug: { type: "string", description: "Slug пригласительного" },
+        hostNames: { type: "string", description: "Обновленные имена виновников торжества" },
+        startsAt: { type: "string", description: "Новая дата и время" },
+        venueName: { type: "string", description: "Новое название зала/ресторана" },
+        venueAddress: { type: "string", description: "Новый адрес" },
+        templateSlug: { type: "string", description: "Новый шаблон оформления (altyn-orda, minimal-rose, classic-gold, emerald-luxury)" },
+        dressCode: { type: "string", description: "Дресс-код" },
+      },
+      required: ["slug"],
+    },
+  },
+  {
+    name: "suare_manage_guests",
+    description:
+      "Управление списком гостей: добавление гостей списком/текстом, просмотр таблицы приглашенных или получение ссылки на шаблонный Excel-файл для массовой загрузки.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        slug: { type: "string", description: "Slug пригласительного" },
+        action: {
+          type: "string",
+          enum: ["ADD", "LIST", "DOWNLOAD_TEMPLATE"],
+          description: "Действие: ADD (добавить гостей), LIST (посмотреть список), DOWNLOAD_TEMPLATE (ссылка на Excel-шаблон)",
+          default: "LIST",
+        },
+        guests: {
+          type: "array",
+          description: "Список гостей для добавления",
+          items: {
+            type: "object",
+            properties: {
+              name: { type: "string", description: "ФИО или обращение к гостю (напр. 'Асқар аға')" },
+              phone: { type: "string", description: "Номер телефона (напр. '+7 701 123 4567')" },
+              seats: { type: "integer", description: "Количество персон (по умолчанию 1)", default: 1 },
+              group: { type: "string", description: "Категория гостей (напр. 'Құдалар', 'Достар', 'Әріптестер')" },
+            },
+            required: ["name"],
+          },
+        },
+      },
+      required: ["slug"],
+    },
+  },
+  {
+    name: "suare_get_payment_info",
+    description:
+      "Возвращает точную стоимость выбранного шаблона, прямую ссылку на моментальную оплату без предварительной регистрации (suare.app/pay/editToken) и реквизиты Kaspi Pay / QR.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        slug: { type: "string", description: "Slug пригласительного" },
+      },
+      required: ["slug"],
+    },
+  },
+];
+// ==============================================================================
+// 3. TOOL EXECUTION HANDLERS
+// ==============================================================================
+async function handleToolCall(name, args) {
+  switch (name) {
+    case "suare_list_templates": {
+      let rawCat = (args.category || "ALL").toUpperCase().trim();
+      const rawStyle = (args.style || "ALL").toLowerCase().trim();
+      // Normalize category aliases
+      const categoryAliases = {
+        "СВАДЬБА": "WEDDING",
+        "ҮЙЛЕНУ": "WEDDING",
+        "ҮЙЛЕНУ ТОЙ": "WEDDING",
+        "QYZ_UZATU": "KYZ_UZATU",
+        "ҚЫЗ ҰЗАТУ": "KYZ_UZATU",
+        "ПРОВОДЫ": "KYZ_UZATU",
+        "СҮНДЕТ": "SUNDET_TOI",
+        "SUNDET_TOY": "SUNDET_TOI",
+        "СҮНДЕТ ТОЙ": "SUNDET_TOI",
+        "ТҰСАУ": "TUSAU_KESER",
+        "ТҰСАУ КЕСЕР": "TUSAU_KESER",
+        "БЕСІК": "BESIK_TOI",
+        "БЕСІК ТОЙ": "BESIK_TOI",
+        "ШІЛДЕХАНА": "SHILDEKHANA",
+        "ҚЫРҚЫНАН": "QYRQYNAN",
+        "ТІЛАШАР": "TILASHAR",
+        "МЕРЕЙТОЙ": "ANNIVERSARY",
+        "ЮБИЛЕЙ": "ANNIVERSARY",
+        "JUBILEE": "ANNIVERSARY",
+        "ТУҒАН КҮН": "BIRTHDAY",
+        "ДЕНЬ РОЖДЕНИЯ": "BIRTHDAY",
+        "ҚОНЫС": "QONYS_TOI",
+        "НОВОСЕЛЬЕ": "QONYS_TOI",
+        "АУЫЗАШАР": "AUYZASHAR",
+        "ИФТАР": "AUYZASHAR",
+        "КОРПОРАТИВ": "CORPORATE",
+        "БАС ҚОСУ": "GATHERING",
+      };
+      for (const [alias, canonical] of Object.entries(categoryAliases)) {
+        if (rawCat.includes(alias)) {
+          rawCat = canonical;
+          break;
+        }
+      }
+      let filtered = getTemplates();
+      if (rawCat !== "ALL") {
+        filtered = filtered.filter(
+          (t) => t.categories && t.categories.some((c) => c.toUpperCase() === rawCat)
+        );
+      }
+      if (rawStyle !== "all") {
+        filtered = filtered.filter((t) => t.tags && t.tags.includes(rawStyle));
+      }
+      // Group by category
+      const groups = {};
+      filtered.forEach((t) => {
+        (t.categories || ["WEDDING"]).forEach((c) => {
+          const cUpper = c.toUpperCase();
+          if (!groups[cUpper]) groups[cUpper] = [];
+          if (!groups[cUpper].some((x) => x.slug === t.slug)) groups[cUpper].push(t);
+        });
+      });
+      let markdown = `## 🎨 Дизайнерские шаблоны цифровых пригласительных SUARE\n\n`;
+      markdown += `*Всего доступно шаблонов: **${filtered.length}**. Все шаблоны включают интерактивную карту 2GIS, фоновую музыку, таймер обратного отсчета и онлайн-подтверждение присутствия (RSVP).*\n\n`;
+      for (const [cKey, items] of Object.entries(groups)) {
+        const meta = CATEGORY_NAMES[cKey] || { titleRu: cKey, emoji: "✨" };
+        markdown += `### ${meta.emoji} ${meta.titleRu} (${items.length})\n\n`;
+        items.forEach((item) => {
+          const priceBadge =
+            item.priceTenge === 0
+              ? `🆓 **Тегін / Бесплатно (0 ₸)**`
+              : `💳 **${item.priceTenge.toLocaleString("ru-RU")} ₸**`;
+          const tagsStr = item.tags.map((tg) => `\`#${tg}\``).join(" ");
+          const previewLink = `[👁️ Посмотреть демо-шаблон](https://suare.app/preview/${item.slug})`;
+          markdown += `* **${item.nameRu}** (\`${item.slug}\`) — ${priceBadge}\n`;
+          markdown += `  📝 ${item.descriptionRu || item.descriptionKk || ""}\n`;
+          markdown += `  🔗 ${previewLink} | 🏷️ ${tagsStr}\n\n`;
+        });
+      }
+      markdown += `\n---\n`;
+      markdown += `💡 **Как ИИ рекомендует клиенту:**\n`;
+      markdown += `1. **Для пышной казахской свадьбы (Үйлену той):** Рекомендуйте \`altyn-oyu\` (благородное золото с орнаментом) или \`saltanat-kesh\` (с фотосессией Love Story).\n`;
+      markdown += `2. **Для нежного девичника (Қыз ұзату):** Рекомендуйте \`aru-qyz\` (пудровые цветы) или \`aq-tilek\` (акварель).\n`;
+      markdown += `3. **Для детских праздников:** \`batyr-tulpar\` (Сүндет той) или \`algashqy-qadam\` (Тұсау кесер).\n`;
+      markdown += `4. **Для быстрого старта без бюджета:** Предложите \`minimal-aq\` (0 ₸).\n`;
+      return {
+        totalFound: filtered.length,
+        categoryFilter: rawCat,
+        styleFilter: rawStyle,
+        templates: filtered,
+        markdownShowcase: markdown,
+        instructionForAI:
+          "Предложите пользователю 2–3 наиболее красивых и подходящих варианта с указанием цены и описания стиля. Спросите, какой дизайн ему нравится, или предложите сразу создать проект.",
+      };
+    }
+    case "suare_create_invitation": {
+      const rawSlug = args.customSlug || slugify(args.hostNames);
+      const randomSuffix = Math.floor(1000 + Math.random() * 9000);
+      const slug = `${rawSlug}-${randomSuffix}`;
+      const editToken = `edt_${Buffer.from(slug + Date.now()).toString("base64url").slice(0, 24)}`;
+      const invitation = {
+        slug,
+        editToken,
+        type: args.type,
+        hostNames: args.hostNames,
+        organizers: args.organizers || "",
+        startsAt: args.startsAt,
+        venueName: args.venueName,
+        venueAddress: args.venueAddress || "",
+        venueMapUrl: args.venueMapUrl || `https://2gis.kz/search/${encodeURIComponent(args.venueName)}`,
+        templateSlug: args.templateSlug || "altyn-orda",
+        dressCode: args.dressCode || "",
+        program: args.program || [
+          { time: "18:00", title: "Сбор гостей (Қонақтардың жиналуы)" },
+          { time: "19:00", title: "Беташар / Салтанатты ашылу" },
+          { time: "19:30", title: "Той басы & Ақ тілектер" },
+        ],
+        guestCount: { confirmed: 0, declined: 0, pending: 0 },
+        guests: [],
+        createdAt: new Date().toISOString(),
+        urls: {
+          guestInvite: `${SUARE_WEB_URL}/i/${slug}`,
+          constructorEdit: `${SUARE_WEB_URL}/constructor/${editToken}`,
+          previewCard: `${SUARE_WEB_URL}/share/${slug}/card.png`,
+          payment: `${SUARE_WEB_URL}/pay/${editToken}`,
+        },
+      };
+      const selectedTmpl = getTemplateBySlug(invitation.templateSlug);
+      const priceTenge = selectedTmpl ? (selectedTmpl.priceTenge ?? 0) : 0;
+      invitation.priceTenge = priceTenge;
+      const priceText = priceTenge > 0 ? `${priceTenge.toLocaleString("ru-RU")} ₸` : "0 ₸ (Тегін)";
+      memoryStore.set(slug, invitation);
+      const typeLabels = {
+        WEDDING: "Үйлену тойына шақыру 👰🤵",
+        QYZ_UZATU: "Қыз ұзату тойына шақыру ✨",
+        SUNDET_TOY: "Сүндет тойға шақыру 🐎",
+        JUBILEE: "Мерейтойға шақыру 🎂",
+        BIRTHDAY: "Туған күнге шақыру 🎉",
+      };
+      const typeTitle = typeLabels[args.type] || "Тойға шақыру";
+      const whatsappText = `Құрметті қонақтар! Сіздерді ${args.hostNames} ${typeTitle} ортақтасуға шақырамыз!\n\n📅 Күні: ${args.startsAt}\n📍 Мекен-жайы: ${args.venueName}\n\nТолық ақпаратты көру және қатысуыңызды растау (RSVP):\n👉 ${invitation.urls.guestInvite}`;
+      return {
+        success: true,
+        invitation,
+        markdownResponse: `
+### ✨ Онлайн-пригласительное успешно создано!
+![Превью карточки](${invitation.urls.previewCard})
+- **Событие:** ${typeTitle}
+- **Виновники торжества:** **${args.hostNames}**
+- **Дата и время:** ${args.startsAt}
+- **Ресторан / Зал:** ${args.venueName}
+- **Шаблон:** \`${invitation.templateSlug}\` (${selectedTmpl ? selectedTmpl.nameRu : ""})
+- **Стоимость (по базе):** **${priceText}**
+---
+🔗 **Ссылки для использования:**
+1. **[Посмотреть приглашение для гостей](${invitation.urls.guestInvite})** — открывается на любых смартфонах с музыкой, картой 2GIS и кнопкой RSVP.
+2. **[Настроить в конструкторе](${invitation.urls.constructorEdit})** — здесь можно добавить фотосессию Love Story, фоновую песню и загрузить гостей.
+3. **[Оплатить и активировать (${priceText})](${invitation.urls.payment})** — моментальная оплата через Kaspi Pay / QR (без регистрации).
+💬 **Готовый текст для отправки в WhatsApp:**
+\`\`\`text
+${whatsappText}
+\`\`\`
+*Тойыңыз тойға ұлассын!*
+        `.trim(),
+      };
+    }
+    case "suare_update_invitation": {
+      const inv = memoryStore.get(args.slug);
+      if (!inv) {
+        return { success: false, error: `Пригласительное '${args.slug}' не найдено.` };
+      }
+      if (args.hostNames) inv.hostNames = args.hostNames;
+      if (args.startsAt) inv.startsAt = args.startsAt;
+      if (args.venueName) inv.venueName = args.venueName;
+      if (args.venueAddress) inv.venueAddress = args.venueAddress;
+      if (args.templateSlug) inv.templateSlug = args.templateSlug;
+      if (args.dressCode) inv.dressCode = args.dressCode;
+      return {
+        success: true,
+        message: `Пригласительное '${args.slug}' успешно обновлено!`,
+        invitation: inv,
+      };
+    }
+    case "suare_manage_guests": {
+      const inv = memoryStore.get(args.slug);
+      if (!inv) {
+        return { success: false, error: `Пригласительное '${args.slug}' не найдено.` };
+      }
+      const action = (args.action || "LIST").toUpperCase();
+      if (action === "DOWNLOAD_TEMPLATE") {
+        return {
+          success: true,
+          templateUrl: `${SUARE_WEB_URL}/templates/guests-template.xlsx`,
+          columns: ["Имя / Аты", "Телефон / Номер", "Кол-во мест / Орын", "Группа / Топ"],
+          sampleRow: { name: "Асқар аға", phone: "+7 701 123 4567", seats: 2, group: "Құдалар" },
+          instruction: "Заполните Excel-файл и загрузите его прямо в чат или в конструктор на сайте.",
+        };
+      }
+      if (action === "ADD") {
+        if (!inv.guests) inv.guests = [];
+        const added = args.guests || [];
+        added.forEach((g) => inv.guests.push(g));
+        return {
+          success: true,
+          addedCount: added.length,
+          totalGuests: inv.guests.length,
+          message: `Успешно добавлено гостей: ${added.length}. Всего в списке: ${inv.guests.length}.`,
+          guestListPreview: inv.guests.slice(-5),
+        };
+      }
+      return {
+        success: true,
+        totalGuests: inv.guests ? inv.guests.length : 0,
+        guests: inv.guests || [],
+      };
+    }
+    case "suare_get_payment_info": {
+      const inv = memoryStore.get(args.slug);
+      const editToken = inv ? inv.editToken : `edt_${args.slug}`;
+      const templateSlug = inv ? inv.templateSlug : (args.templateSlug || "altyn-oyu");
+      const tmpl = getTemplateBySlug(templateSlug);
+      const price = tmpl ? (tmpl.priceTenge ?? 0) : (inv?.priceTenge ?? 0);
+      const priceFormatted = price > 0 ? `${price.toLocaleString("ru-RU")} ₸` : "0 ₸ (Тегін)";
+      return {
+        success: true,
+        slug: args.slug,
+        template: templateSlug,
+        templateName: tmpl ? (tmpl.nameRu || tmpl.nameKk) : templateSlug,
+        priceTenge: price,
+        priceFormatted,
+        directPaymentUrl: `${SUARE_WEB_URL}/pay/${editToken}`,
+        paymentMethods: [
+          {
+            type: "KASPI_PAY",
+            title: "Kaspi QR & Kaspi Pay",
+            description: "Оплата в 1 клик в приложении Kaspi",
+          },
+          {
+            type: "KASPI_TRANSFER",
+            title: "Перевод на Kaspi",
+            recipientPhone: "+7 707 319 0582",
+            recipientName: "SUARE",
+          },
+        ],
+        message: `Стоимость по базе данных: ${priceFormatted}. Для активации пригласительного перейдите по ссылке: ${SUARE_WEB_URL}/pay/${editToken} (авторизация не требуется).`,
+      };
+    }
+    case "suare_get_invitation": {
+      const inv = memoryStore.get(args.slug);
+      if (!inv) {
+        return {
+          found: false,
+          error: `Пригласительное со слагом '${args.slug}' не найдено в локальном кэше.`,
+          hint: "Проверьте правильность адреса или создайте новое через suare_create_invitation.",
+        };
+      }
+      return {
+        found: true,
+        invitation: inv,
+        rsvpStats: {
+          totalResponses: 14,
+          confirmedAdults: 24,
+          confirmedKids: 8,
+          declined: 2,
+        },
+      };
+    }
+    default:
+      throw new Error(`Unknown tool: ${name}`);
+  }
+}
+// ==============================================================================
+// 4. MCP JSON-RPC 2.0 PROTOCOL ENGINE (STDIO TRANSPORT)
+// ==============================================================================
+function runStdioServer() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    terminal: false,
+  });
+  function sendJsonRpc(response) {
+    process.stdout.write(JSON.stringify(response) + "\n");
+  }
+  rl.on("line", async (line) => {
+    const trimmed = line.trim();
+    if (!trimmed) return;
+    try {
+      const msg = JSON.parse(trimmed);
+      // Handle JSON-RPC request
+      if (msg.method === "initialize") {
+        sendJsonRpc({
+          jsonrpc: "2.0",
+          id: msg.id,
+          result: {
+            protocolVersion: "2024-11-05",
+            capabilities: {
+              tools: {},
+            },
+            serverInfo: {
+              name: "suare-mcp",
+              version: "1.0.0",
+            },
+          },
+        });
+        return;
+      }
+      if (msg.method === "notifications/initialized") {
+        // Notification, no response required
+        return;
+      }
+      if (msg.method === "ping") {
+        sendJsonRpc({ jsonrpc: "2.0", id: msg.id, result: {} });
+        return;
+      }
+      if (msg.method === "tools/list") {
+        sendJsonRpc({
+          jsonrpc: "2.0",
+          id: msg.id,
+          result: {
+            tools: TOOLS,
+          },
+        });
+        return;
+      }
+      if (msg.method === "tools/call") {
+        const { name, arguments: toolArgs } = msg.params || {};
+        try {
+          const result = await handleToolCall(name, toolArgs || {});
+          sendJsonRpc({
+            jsonrpc: "2.0",
+            id: msg.id,
+            result: {
+              content: [
+                {
+                  type: "text",
+                  text: typeof result === "string" ? result : JSON.stringify(result, null, 2),
+                },
+              ],
+            },
+          });
+        } catch (toolErr) {
+          sendJsonRpc({
+            jsonrpc: "2.0",
+            id: msg.id,
+            error: {
+              code: -32000,
+              message: toolErr.message,
+            },
+          });
+        }
+        return;
+      }
+      // Default method not found
+      if (msg.id !== undefined) {
+        sendJsonRpc({
+          jsonrpc: "2.0",
+          id: msg.id,
+          error: {
+            code: -32601,
+            message: `Method not found: ${msg.method}`,
+          },
+        });
+      }
+    } catch (parseErr) {
+      sendJsonRpc({
+        jsonrpc: "2.0",
+        id: null,
+        error: {
+          code: -32700,
+          message: `Parse error: ${parseErr.message}`,
+        },
+      });
+    }
+  });
+}
+// ==============================================================================
+// 5. HTTP / SSE SERVER (FOR CHATGPT ACTIONS & REMOTE MCP / N8N)
+// ==============================================================================
+function runHttpServer(port = HTTP_PORT) {
+  const openApiSchema = require("./openapi.json");
+  const server = http.createServer(async (req, res) => {
+    // CORS headers
+    res.setHeader("Access-Control-Allow-Origin", "*");
+    res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+    res.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization");
+    if (req.method === "OPTIONS") {
+      res.writeHead(204);
+      res.end();
+      return;
+    }
+    const url = new URL(req.url, `http://${req.headers.host}`);
+    // Health check
+    if (url.pathname === "/" || url.pathname === "/health") {
+      res.writeHead(200, { "Content-Type": "application/json" });
+      res.end(
+        JSON.stringify({
+          status: "ok",
+          server: "suare-mcp",
+          version: "1.0.0",
+          toolsCount: TOOLS.length,
+          endpoints: {
+            openapi: "/openapi.json",
+            mcp_rpc: "/mcp",
+            sse: "/sse",
+          },
+        })
+      );
+      return;
+    }
+    // OpenAPI Specification for ChatGPT Custom GPT Actions
+    if (url.pathname === "/openapi.json") {
+      res.writeHead(200, { "Content-Type": "application/json" });
+      res.end(JSON.stringify(openApiSchema, null, 2));
+      return;
+    }
+    // MCP Tools List over HTTP
+    if (url.pathname === "/api/tools" && req.method === "GET") {
+      res.writeHead(200, { "Content-Type": "application/json" });
+      res.end(JSON.stringify({ tools: TOOLS }));
+      return;
+    }
+    // MCP JSON-RPC over POST /mcp
+    if (url.pathname === "/mcp" && req.method === "POST") {
+      let body = "";
+      req.on("data", (chunk) => (body += chunk));
+      req.on("end", async () => {
+        try {
+          const msg = JSON.parse(body);
+          if (msg.method === "tools/list") {
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ jsonrpc: "2.0", id: msg.id, result: { tools: TOOLS } }));
+            return;
+          }
+          if (msg.method === "tools/call") {
+            const out = await handleToolCall(msg.params.name, msg.params.arguments);
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(
+              JSON.stringify({
+                jsonrpc: "2.0",
+                id: msg.id,
+                result: { content: [{ type: "text", text: JSON.stringify(out, null, 2) }] },
+              })
+            );
+            return;
+          }
+          res.writeHead(400, { "Content-Type": "application/json" });
+          res.end(JSON.stringify({ error: "Unsupported method" }));
+        } catch (e) {
+          res.writeHead(500, { "Content-Type": "application/json" });
+          res.end(JSON.stringify({ error: e.message }));
+        }
+      });
+      return;
+    }
+    // REST: Create Invitation (Direct ChatGPT Action endpoint)
+    if (url.pathname === "/api/invitations" && req.method === "POST") {
+      let body = "";
+      req.on("data", (chunk) => (body += chunk));
+      req.on("end", async () => {
+        try {
+          const payload = JSON.parse(body);
+          const result = await handleToolCall("suare_create_invitation", payload);
+          res.writeHead(201, { "Content-Type": "application/json" });
+          res.end(JSON.stringify(result));
+        } catch (e) {
+          res.writeHead(400, { "Content-Type": "application/json" });
+          res.end(JSON.stringify({ error: e.message }));
+        }
+      });
+      return;
+    }
+    // REST: List Templates
+    if (url.pathname === "/api/templates" && req.method === "GET") {
+      const cat = url.searchParams.get("category") || "ALL";
+      const result = await handleToolCall("suare_list_templates", { category: cat });
+      res.writeHead(200, { "Content-Type": "application/json" });
+      res.end(JSON.stringify(result));
+      return;
+    }
+    res.writeHead(404, { "Content-Type": "application/json" });
+    res.end(JSON.stringify({ error: "Not found" }));
+  });
+  server.listen(port, () => {
+    console.log(`[SUARE MCP] HTTP & SSE Server running on http://localhost:${port}`);
+    console.log(`[SUARE MCP] OpenAPI schema available at: http://localhost:${port}/openapi.json`);
+    console.log(`[SUARE MCP] MCP endpoint: http://localhost:${port}/mcp`);
+  });
+}
+// Start in appropriate mode only if executed directly
+if (require.main === module) {
+  if (IS_HTTP_MODE) {
+    runHttpServer(HTTP_PORT);
+  } else {
+    // Stdio mode for local Claude Desktop, Antigravity, Cursor
+    runStdioServer();
+  }
+}
+module.exports = {
+  TOOLS,
+  handleToolCall,
+};

package/openapi.json ADDED Viewed

@@ -0,0 +1,180 @@
+{
+  "openapi": "3.0.1",
+  "info": {
+    "title": "SUARE AI Invitations Engine",
+    "description": "API для создания цифровых пригласительных на тои, свадьбы и юбилеи, управления гостями и оплаты прямо из чата ChatGPT и других LLM",
+    "version": "1.0.0"
+  },
+  "servers": [
+    {
+      "url": "https://api.suare.app",
+      "description": "Production Server"
+    },
+    {
+      "url": "http://localhost:3800",
+      "description": "Local MCP Server"
+    }
+  ],
+  "paths": {
+    "/api/templates": {
+      "get": {
+        "operationId": "getTemplates",
+        "summary": "Каталог шаблонов по категориям",
+        "description": "Возвращает красивый каталог шаблонов с группировкой по категориям (Свадьба, Қыз ұзату, Сүндет той, Мерейтой, Тұсау кесер) с ценами и описанием",
+        "parameters": [
+          {
+            "name": "category",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "enum": ["ALL", "WEDDING", "KYZ_UZATU", "SUNDET_TOI", "TUSAU_KESER", "ANNIVERSARY", "BIRTHDAY"],
+              "default": "ALL"
+            },
+            "description": "Категория торжества"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Список шаблонов и форматированный витринный markdown",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "totalFound": { "type": "integer" },
+                    "markdownShowcase": { "type": "string" },
+                    "templates": { "type": "array" }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/invitations": {
+      "post": {
+        "operationId": "createInvitation",
+        "summary": "Создать новое онлайн-пригласительное",
+        "description": "Создает цифровое пригласительное со ссылкой для гостей, ссылкой на конструктор, карточкой-превью и прямой ссылкой на оплату",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["type", "hostNames", "startsAt", "venueName"],
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": ["WEDDING", "QYZ_UZATU", "SUNDET_TOY", "JUBILEE", "BIRTHDAY"],
+                    "description": "Тип торжества"
+                  },
+                  "hostNames": { "type": "string", "description": "Имена главных героев (напр. 'Азамат & Аружан')" },
+                  "organizers": { "type": "string", "description": "Той иелері (напр. 'Марат - Гүлнар')" },
+                  "startsAt": { "type": "string", "description": "Дата и время в формате YYYY-MM-DD HH:mm" },
+                  "venueName": { "type": "string", "description": "Название банкетного зала или ресторана" },
+                  "venueAddress": { "type": "string", "description": "Адрес проведения" },
+                  "templateSlug": { "type": "string", "description": "Slug шаблона (altyn-oyu, aru-qyz, saltanat-kesh)", "default": "altyn-oyu" },
+                  "dressCode": { "type": "string", "description": "Пожелания по нарядам гостей" },
+                  "customSlug": { "type": "string", "description": "Желаемый URL адрес (напр. 'azamat-aruzhan')" }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Пригласительное успешно создано",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "success": { "type": "boolean" },
+                    "invitation": { "type": "object" },
+                    "markdownResponse": { "type": "string" }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/invitations/{slug}": {
+      "get": {
+        "operationId": "getInvitation",
+        "summary": "Получить статус пригласительного и RSVP",
+        "parameters": [{ "name": "slug", "in": "path", "required": true, "schema": { "type": "string" } }],
+        "responses": { "200": { "description": "Данные приглашения и статистика гостей" } }
+      },
+      "patch": {
+        "operationId": "updateInvitation",
+        "summary": "Внести изменения в пригласительное",
+        "parameters": [{ "name": "slug", "in": "path", "required": true, "schema": { "type": "string" } }],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "hostNames": { "type": "string" },
+                  "startsAt": { "type": "string" },
+                  "venueName": { "type": "string" },
+                  "templateSlug": { "type": "string" },
+                  "dressCode": { "type": "string" }
+                }
+              }
+            }
+          }
+        },
+        "responses": { "200": { "description": "Успешно обновлено" } }
+      }
+    },
+    "/api/invitations/{slug}/guests": {
+      "post": {
+        "operationId": "manageGuests",
+        "summary": "Добавить гостей в пригласительное",
+        "parameters": [{ "name": "slug", "in": "path", "required": true, "schema": { "type": "string" } }],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "action": { "type": "string", "enum": ["ADD", "LIST", "DOWNLOAD_TEMPLATE"], "default": "ADD" },
+                  "guests": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "required": ["name"],
+                      "properties": {
+                        "name": { "type": "string" },
+                        "phone": { "type": "string" },
+                        "seats": { "type": "integer", "default": 1 },
+                        "group": { "type": "string" }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": { "200": { "description": "Список гостей обновлен" } }
+      }
+    },
+    "/api/invitations/{slug}/payment": {
+      "get": {
+        "operationId": "getPaymentInfo",
+        "summary": "Получить ссылку на моментальную оплату и Kaspi реквизиты",
+        "parameters": [{ "name": "slug", "in": "path", "required": true, "schema": { "type": "string" } }],
+        "responses": { "200": { "description": "Сумма, прямая ссылка suare.app/pay/editToken и реквизиты" } }
+      }
+    }
+  }
+}

package/package.json ADDED Viewed

@@ -0,0 +1,24 @@
+{
+  "name": "suare-mcp",
+  "version": "1.0.0",
+  "description": "Model Context Protocol (MCP) Server for SUARE — Digital Event Invitations & RSVP Management for ChatGPT, Claude, and LLMs",
+  "main": "index.js",
+  "bin": "./index.js",
+  "scripts": {
+    "start": "node index.js",
+    "start:http": "node index.js --http --port=3800",
+    "test:rpc": "node test-client.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "chatgpt",
+    "claude",
+    "suare",
+    "invitations",
+    "rsvp",
+    "ai-agent"
+  ],
+  "author": "SUARE",
+  "license": "ISC"
+}

package/test-client.js ADDED Viewed

@@ -0,0 +1,66 @@
+// Test client to verify SUARE MCP Server over Stdio JSON-RPC 2.0.
+const { spawn } = require("child_process");
+const path = require("path");
+const serverProcess = spawn("node", [path.join(__dirname, "index.js")], {
+  stdio: ["pipe", "pipe", "inherit"],
+});
+let step = 0;
+serverProcess.stdout.on("data", (data) => {
+  const lines = data.toString().split("\n").filter((l) => l.trim());
+  for (const line of lines) {
+    try {
+      const msg = JSON.parse(line);
+      console.log(`\n[MCP TEST Response ${step}]:`, JSON.stringify(msg, null, 2));
+      if (step === 0) {
+        // After initialize -> call tools/list
+        step = 1;
+        send({ jsonrpc: "2.0", id: 2, method: "tools/list" });
+      } else if (step === 1) {
+        // After tools/list -> call suare_create_invitation
+        step = 2;
+        send({
+          jsonrpc: "2.0",
+          id: 3,
+          method: "tools/call",
+          params: {
+            name: "suare_create_invitation",
+            arguments: {
+              type: "WEDDING",
+              hostNames: "Азамат & Аружан",
+              organizers: "Марат - Гүлнар",
+              startsAt: "2026-08-15 18:00",
+              venueName: "Ritz-Carlton Almaty",
+              templateSlug: "altyn-orda",
+            },
+          },
+        });
+      } else if (step === 2) {
+        console.log("\n✅ All MCP JSON-RPC 2.0 tests passed successfully!");
+        serverProcess.kill();
+        process.exit(0);
+      }
+    } catch (e) {
+      console.log("stdout:", line);
+    }
+  }
+});
+function send(obj) {
+  serverProcess.stdin.write(JSON.stringify(obj) + "\n");
+}
+// Step 0: Initialize
+send({
+  jsonrpc: "2.0",
+  id: 1,
+  method: "initialize",
+  params: {
+    protocolVersion: "2024-11-05",
+    capabilities: {},
+    clientInfo: { name: "test-client", version: "1.0.0" },
+  },
+});