sopo-mcp 1.0.0

package/.dockerignore

@@ -0,0 +1,10 @@
+node_modules
+dist
+.env
+npm-debug.log
+Dockerfile
+.dockerignore
+.git
+.gitignore
+README.md
+GUIDE.md

package/.env

@@ -0,0 +1,7 @@
+# Sopo Backend URL (where sopo_backend is running)
+SOPO_BACKEND_URL=https://sopo-backend-ebbe5030f148.hosted.ghaymah.systems
+
+# Authentication: Provide a valid JWT access token for the Sopo Backend.
+# This token is used by the MCP server to authenticate all API calls.
+# You can obtain this token by signing in through the Sopo Backend auth endpoints.
+SOPO_ACCESS_TOKEN=your_jwt_access_token_here

package/.ghaymah.json

@@ -0,0 +1,20 @@
+{
+  "id": "3a1850f8-684b-4b16-bf86-2f8d4b58d3bc",
+  "name": "sopo-mcp-server",
+  "projectId": "dcec3220-caed-40a4-aaa6-d66fbe7533d6",
+  "ports": [
+    {
+      "expose": true,
+      "number": 4000
+    }
+  ],
+  "publicAccess": {
+    "enabled": true,
+    "domain": "auto"
+  },
+  "env": {
+    "SOPO_BACKEND_URL": "https://sopo-backend-ebbe5030f148.hosted.ghaymah.systems"
+  },
+  "resourceTier": "t7",
+  "dockerFileName": "Dockerfile"
+}

package/Dockerfile

@@ -0,0 +1,37 @@
+# Use an official Node.js runtime as a parent image
+FROM node:22-alpine AS builder
+
+# Set the working directory in the container
+WORKDIR /app
+
+# Copy package files to install dependencies
+COPY package*.json ./
+
+# Install all dependencies (including devDependencies needed for build)
+RUN npm ci
+
+# Copy the rest of the application code
+COPY . .
+
+# Build the TypeScript code
+RUN npm run build
+
+# Production stage using a smaller image
+FROM node:22-alpine
+
+WORKDIR /app
+
+# Copy package files
+COPY package*.json ./
+
+# Install only production dependencies
+RUN npm ci --omit=dev
+
+# Copy compiled files from the builder stage
+COPY --from=builder /app/dist ./dist
+
+# Set the environment to production
+ENV NODE_ENV=production
+
+# Command to run the MCP server
+CMD ["node", "dist/index.js"]

package/GUIDE.md

@@ -0,0 +1,311 @@
+<div dir="rtl" style="text-align: right; font-family: sans-serif;">
+
+# 📘 دليل استخدام Sopo MCP Server
+
+---
+
+## ❓ إيه هو الـ MCP Server ده؟
+
+الـ **MCP (Model Context Protocol)** هو بروتوكول رسمي من Anthropic بيسمح لنماذج الذكاء الاصطناعي (زي Claude) إنها **تتفاعل مباشرة** مع أنظمة وبرامج خارجية.
+
+الـ **Sopo MCP Server** هو جسر بين الـ AI وبين **Sopo Backend**، بيخلي الذكاء الاصطناعي يقدر:
+- 📖 **يقرأ** بيانات الـ Gateways والـ Services والـ Routes
+- ✏️ **ينشئ ويعدل ويحذف** أي مورد في المنصة
+- 📊 **يراقب** سجلات الطلبات والمقاييس والإحصائيات
+- 🔧 **ينفذ سيناريوهات معقدة** زي إنشاء بوابة كاملة بضغطة واحدة
+
+---
+
+## 🛠️ إزاي أجهزه؟
+
+### الخطوة 1: ضبط ملف `.env`
+
+في مجلد `sopo-mcp-server`، افتح ملف `.env` وحط القيم الصحيحة:
+
+```env
+# عنوان الباك إند (لو شغال محلياً)
+SOPO_BACKEND_URL=http://localhost:4000
+
+# أو لو على السيرفر السحابي
+# SOPO_BACKEND_URL=https://sopo-backend-ebbe5030f148.hosted.ghaymah.systems
+
+# التوكن: ده بيبقى JWT Access Token بتاعك
+# تقدر تجيبه لما تعمل Login من الفرونت إند أو من Insomnia
+SOPO_ACCESS_TOKEN=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
+```
+
+#### 💡 إزاي أجيب الـ Access Token؟
+1. سجل دخول من الـ **Sopo Frontend** عادي
+2. افتح **DevTools** في المتصفح (F12)
+3. روح على تاب **Application** → **Cookies** أو **Local Storage**
+4. هتلاقي الـ `accessToken` — انسخه
+5. حطه في `.env` في خانة `SOPO_ACCESS_TOKEN`
+
+---
+
+### الخطوة 2: تثبيت وبناء المشروع
+
+```bash
+cd sopo-mcp-server
+npm install
+npm run build
+```
+
+---
+
+### الخطوة 3: ربطه بـ Claude Desktop
+
+افتح ملف إعدادات Claude Desktop:
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+- **Mac**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+أضف الإعداد ده:
+
+```json
+{
+  "mcpServers": {
+    "sopo": {
+      "command": "node",
+      "args": ["d:/FCI/Fourth/Graduation Project/Code/sopo-mcp-server/dist/index.js"],
+      "env": {
+        "SOPO_BACKEND_URL": "http://localhost:4000",
+        "SOPO_ACCESS_TOKEN": "ضع_التوكن_هنا"
+      }
+    }
+  }
+}
+```
+
+بعد كده **أعد تشغيل Claude Desktop** وهتلاقي أيقونة 🔧 جنب مربع الكتابة — معناها إن الـ MCP متصل.
+
+---
+
+### الخطوة 4 (اختياري): الاختبار بالـ MCP Inspector
+
+```bash
+npm run inspect
+```
+
+ده بيفتح واجهة ويب تقدر تجرب منها كل الأدوات يدوياً.
+
+---
+
+## 🤖 الـ AI يقدر يعمل إيه؟
+
+### 🔷 إدارة الـ Gateways (البوابات)
+
+| الأداة | الوصف |
+|---|---|
+| `list_gateways` | عرض كل البوابات الخاصة بيك |
+| `create_gateway` | إنشاء بوابة جديدة |
+| `update_gateway` | تعديل اسم أو حالة بوابة |
+| `delete_gateway` | حذف بوابة |
+
+**مثال محادثة:**
+> 🧑 "اعرض كل البوابات اللي عندي"
+> 🤖 يستدعي `list_gateways` ويعرض القائمة
+> 🧑 "اعمل بوابة جديدة اسمها production-api في وضع pro"
+> 🤖 يستدعي `create_gateway` بالاسم والوضع
+
+---
+
+### 🔷 إدارة الـ Services (الخدمات)
+
+| الأداة | الوصف |
+|---|---|
+| `list_services` | عرض كل الخدمات |
+| `create_service` | إنشاء خدمة تحت بوابة معينة |
+| `update_service` | تعديل إعدادات الخدمة |
+| `delete_service` | حذف خدمة |
+
+**مثال محادثة:**
+> 🧑 "أضف خدمة اسمها user-api تحت البوابة production-api بروتوكول http وتوزيع حمل round_robin"
+> 🤖 يستدعي `create_service` بالمعلومات المطلوبة
+
+---
+
+### 🔷 إدارة الـ Service Targets (عناوين الخدمات)
+
+| الأداة | الوصف |
+|---|---|
+| `list_service_targets` | عرض كل عناوين URL |
+| `create_service_target` | إضافة عنوان URL لخدمة |
+| `update_service_target` | تعديل العنوان |
+| `delete_service_target` | حذف العنوان |
+
+**مثال محادثة:**
+> 🧑 "أضف عنوان https://api.example.com للخدمة user-api بوزن 1"
+> 🤖 يستدعي `create_service_target`
+
+---
+
+### 🔷 إدارة الـ Routes (المسارات)
+
+| الأداة | الوصف |
+|---|---|
+| `list_gateway_routes` | عرض كل المسارات |
+| `create_gateway_route` | إنشاء مسار يربط path بخدمة |
+| `update_gateway_route` | تعديل مسار |
+| `delete_gateway_route` | حذف مسار |
+
+**مثال محادثة:**
+> 🧑 "اعمل مسار /api/users على البوابة production-api يوجه للخدمة user-api"
+> 🤖 يستدعي `create_gateway_route`
+
+---
+
+### 🔷 إدارة الـ Plugins (الإضافات/الميدل وير)
+
+| الأداة | الوصف |
+|---|---|
+| `list_gateway_plugins` | عرض كل الإضافات |
+| `create_gateway_plugin` | تركيب إضافة على بوابة أو مسار |
+| `update_gateway_plugin` | تعديل إعدادات إضافة |
+| `delete_gateway_plugin` | حذف إضافة |
+
+**مثال محادثة:**
+> 🧑 "فعّل rate limiting على البوابة production-api بحد أقصى 100 طلب في الدقيقة"
+> 🤖 يستدعي `create_gateway_plugin` بـ name "rate_limit" و plugin_config مناسب
+
+---
+
+### 🔷 إدارة الـ Aggregate Requests (الطلبات المتوازية)
+
+| الأداة | الوصف |
+|---|---|
+| `list_aggregate_requests` | عرض الطلبات المتوازية |
+| `create_aggregate_request` | إنشاء طلب متوازي |
+| `update_aggregate_request` | تعديل طلب |
+| `delete_aggregate_request` | حذف طلب |
+
+---
+
+### 🔷 إدارة الـ Collections (المجموعات)
+
+| الأداة | الوصف |
+|---|---|
+| `list_collections` | عرض المجموعات |
+| `create_collection` | إنشاء مجموعة تنظيمية |
+| `update_collection` | تعديل مجموعة |
+| `delete_collection` | حذف مجموعة |
+
+---
+
+### 🔷 إدارة الـ User Profiles (ملفات المستخدمين)
+
+| الأداة | الوصف |
+|---|---|
+| `get_user_profile` | عرض بروفايلك والـ slug بتاعك |
+| `create_user_profile` | إنشاء بروفايل بـ slug جديد |
+| `update_user_profile` | تعديل الـ slug |
+| `delete_user_profile` | حذف البروفايل |
+
+---
+
+### 🔷 المراقبة والإحصائيات (Observability)
+
+| الأداة | الوصف |
+|---|---|
+| `check_health` | فحص حالة النظام (شغال ولا لا) |
+| `get_resource_stats` | عدد البوابات والخدمات والمسارات والإضافات |
+| `get_request_logs` | سجل الطلبات الأخيرة (من ClickHouse) |
+| `get_hourly_metrics` | إحصائيات كل ساعة (طلبات، أخطاء، زمن استجابة) |
+| `get_hourly_metrics_mv` | نفس الإحصائيات بس أسرع (Materialized View) |
+
+**مثال محادثة:**
+> 🧑 "إيه حالة النظام دلوقتي؟"
+> 🤖 يستدعي `check_health` + `get_resource_stats` + `get_hourly_metrics` ويعرض تقرير شامل
+
+---
+
+## 💬 القوالب الجاهزة (Prompts)
+
+دي سيناريوهات معقدة جاهزة بتنفذ عدة خطوات مرة واحدة:
+
+### 1. `setup_new_gateway` — إنشاء بوابة كاملة من الصفر
+بيسألك:
+- اسم البوابة
+- عنوان URL للخدمة
+- المسار اللي عايزه
+
+وبينفذ تلقائياً: إنشاء Gateway → Service → ServiceTarget → Route
+
+### 2. `diagnose_gateway` — تشخيص بوابة
+بيفحص بوابة معينة ويقولك:
+- ✅ الحاجات اللي تمام
+- ⚠️ المشاكل المحتملة
+- 🔧 الإجراءات المقترحة
+
+### 3. `platform_report` — تقرير شامل عن المنصة
+بيجمع كل البيانات ويعمل تقرير كامل عن حالة المنصة.
+
+### 4. `add_plugin_to_gateway` — إضافة plugin
+بيسألك اسم البوابة ونوع الـ plugin وبيركبه تلقائياً.
+
+---
+
+## 🎯 أمثلة عملية كاملة
+
+### مثال 1: إنشاء بوابة كاملة
+
+> 🧑 "عايز أعمل بوابة API كاملة اسمها my-api توجه المسار /users لـ https://jsonplaceholder.typicode.com"
+
+الـ AI هيعمل:
+1. `create_gateway` → ينشئ بوابة "my-api"
+2. `create_service` → ينشئ خدمة تحت البوابة
+3. `create_service_target` → يضيف عنوان URL
+4. `create_gateway_route` → يربط المسار /users بالخدمة
+
+---
+
+### مثال 2: تشخيص مشكلة
+
+> 🧑 "حاسس إن البوابة بطيئة، اعملي تحليل"
+
+الـ AI هيعمل:
+1. `get_resource_stats` → يشوف عدد الموارد
+2. `get_hourly_metrics` → يحلل الأداء
+3. `get_request_logs` → يبحث عن أخطاء أو بطء
+4. يقدم تقرير بالمشاكل والحلول
+
+---
+
+### مثال 3: إضافة حماية
+
+> 🧑 "عايز أضيف API Key authentication على البوابة my-api"
+
+الـ AI هيعمل:
+1. `list_gateways` → يلاقي الـ ID بتاع "my-api"
+2. `create_gateway_plugin` → يركب plugin "apikey" على البوابة
+
+---
+
+## ⚙️ ملاحظات مهمة
+
+1. **الـ Access Token**: لازم يكون **صالح** (مش منتهي الصلاحية). لو انتهى، سجل دخول تاني وجدد التوكن.
+2. **الـ Backend لازم يكون شغال**: الـ MCP بيتواصل مع الـ Backend عبر HTTP، فلازم الباك إند يكون شغال.
+3. **الصلاحيات**: الـ AI بيشتغل بنفس صلاحيات التوكن اللي إنت حاططه. يعني لو التوكن بتاع يوزر معين، الـ AI هيشوف بس بيانات اليوزر ده (بفضل Hasura RLS).
+4. **الـ Transport**: الـ MCP بيستخدم `stdio` (Standard I/O)، يعني Claude Desktop بيشغل الـ Server كـ process محلي ويتواصل معاه عبر stdin/stdout.
+
+---
+
+## 📁 هيكل الملفات
+
+```
+sopo-mcp-server/
+├── .env                  ← إعدادات البيئة (التوكن والعنوان)
+├── .env.example          ← نموذج الإعدادات
+├── package.json          ← التبعيات والسكربتات
+├── tsconfig.json         ← إعدادات TypeScript
+├── README.md             ← التوثيق بالإنجليزي
+├── GUIDE.md              ← الدليل ده (بالعربي)
+├── src/
+│   ├── index.ts          ← نقطة البداية الرئيسية
+│   ├── sopo-client.ts    ← عميل HTTP للتواصل مع الباك إند
+│   ├── tools/            ← 37 أداة MCP
+│   ├── resources/        ← 3 موارد للقراءة فقط
+│   └── prompts/          ← 4 قوالب جاهزة
+└── dist/                 ← الكود المبني (JavaScript)
+```
+
+</div>

package/README.md

@@ -0,0 +1,143 @@
+# sopo-mcp
+
+> Model Context Protocol (MCP) server for the **Sopo API Gateway Platform**.  
+> Enables AI models (like Claude) to fully manage and monitor the Sopo platform through natural language.
+
+## Installation
+
+To install sopo-mcp globally:
+
+```bash
+npm install -g sopo-mcp
+```
+
+Or install locally in your project:
+
+```bash
+npm install sopo-mcp
+```
+
+## Features
+
+### 🔧 37 Tools (Full CRUD)
+| Domain | Tools | Description |
+|---|---|---|
+| **Gateways** | `list_gateways`, `create_gateway`, `update_gateway`, `delete_gateway` | Manage API gateway instances |
+| **Services** | `list_services`, `create_service`, `update_service`, `delete_service` | Manage upstream backends |
+| **Service Targets** | `list_service_targets`, `create_service_target`, `update_service_target`, `delete_service_target` | Manage load balancing URLs |
+| **Routes** | `list_gateway_routes`, `create_gateway_route`, `update_gateway_route`, `delete_gateway_route` | Manage path → service mappings |
+| **Plugins** | `list_gateway_plugins`, `create_gateway_plugin`, `update_gateway_plugin`, `delete_gateway_plugin` | Manage middleware (auth, rate-limit, etc.) |
+| **Aggregation** | `list_aggregate_requests`, `create_aggregate_request`, `update_aggregate_request`, `delete_aggregate_request` | Manage parallel sub-requests |
+| **Collections** | `list_collections`, `create_collection`, `update_collection`, `delete_collection` | Manage organizational groups |
+| **User Profiles** | `get_user_profile`, `create_user_profile`, `update_user_profile`, `delete_user_profile` | Manage user slugs |
+| **Observability** | `check_health`, `get_resource_stats`, `get_request_logs`, `get_hourly_metrics`, `get_hourly_metrics_mv` | Monitor system health and performance |
+
+### 📚 3 Resources (Read-Only Context)
+- **Platform Overview** (`sopo://platform/overview`) — Architecture, domain model, and API documentation
+- **Gateway Config** (`sopo://gateways/current-config`) — Live gateway configuration snapshot
+- **Resource Stats** (`sopo://stats/resources`) — Live resource counts
+
+### 💬 4 Prompts (Guided Workflows)
+- **`setup_new_gateway`** — Step-by-step gateway creation with service, target, and route
+- **`diagnose_gateway`** — Comprehensive health diagnosis of a gateway
+- **`platform_report`** — Full platform status report
+- **`add_plugin_to_gateway`** — Guided plugin attachment
+
+## Quick Start
+
+### 1. Configure Environment
+
+Set the `SOPO_BACKEND_URL` environment variable pointing to your Sopo backend:
+
+```bash
+# For Unix/Linux/macOS
+export SOPO_BACKEND_URL=https://sopo-backend-ebbe5030f148.hosted.ghaymah.systems
+
+# Windows PowerShell
+$env:SOPO_BACKEND_URL="https://sopo-backend-ebbe5030f148.hosted.ghaymah.systems"
+```
+
+### 2. Usage
+
+#### Option A: Use in Claude Desktop
+
+Add this to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "sopo": {
+      "command": "npx",
+      "args": ["sopo-mcp"],
+      "env": {
+        "SOPO_BACKEND_URL": "https://sopo-backend-ebbe5030f148.hosted.ghaymah.systems"
+      }
+    }
+  }
+}
+```
+
+#### Option B: Use in Cursor / Windsurf (SSE)
+
+If you are using an IDE that supports SSE, you can use the hosted server:
+- **Type:** `SSE`
+- **URL:** `https://sopo-mcp-server-2aa6baac9e7f.hosted.ghaymah.systems`
+
+#### Option C: Local Installation from Source
+
+```bash
+# Clone the repo
+git clone <your-repo-url>
+cd sopo-mcp
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Start
+npm start
+```
+
+### 3. Test with MCP Inspector (Optional)
+
+```bash
+npm run inspect
+```
+
+## Architecture
+
+```
+┌──────────────┐    stdio / SSE   ┌──────────────────┐     HTTP      ┌──────────────┐
+│  AI Client   │ ◄───────────────►│  Sopo MCP Server  │ ───────────► │ Sopo Backend │
+│ (Claude etc.)│                  │  (Hosted/Local)   │              │  (port 4000) │
+└──────────────┘                  └──────────────────┘              └──────────────┘
+                                           │                              │
+                                    37 Tools                     Express REST API
+                                    3 Resources                        │
+                                    4 Prompts                    Hasura GraphQL
+                                                                       │
+                                                                 ┌─────┴─────┐
+                                                                 │PostgreSQL │ │ClickHouse│
+                                                                 │ (config)  │ │ (logs)   │
+                                                                 └───────────┘ └──────────┘
+```
+
+## Package Name
+
+The package is published as `sopo-mcp` on npm. Users can install it using:
+
+```bash
+npm install sopo-mcp
+```
+
+Or run it directly with:
+
+```bash
+npx sopo-mcp
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+/**
+ * ╔═══════════════════════════════════════════════════════════════╗
+ * ║                    Sopo MCP Server                           ║
+ * ║                                                              ║
+ * ║  Model Context Protocol server for the Sopo API Gateway      ║
+ * ║  platform. Enables AI models (Claude, etc.) to manage        ║
+ * ║  gateways, services, routes, plugins, and monitor metrics.   ║
+ * ╚═══════════════════════════════════════════════════════════════╝
+ *
+ * Transport: stdio (for Claude Desktop / local AI clients)
+ *
+ * Environment Variables:
+ *   SOPO_BACKEND_URL   — Base URL of the Sopo Backend (default: http://localhost:4000)
+ *   SOPO_ACCESS_TOKEN  — JWT access token for authentication
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { configureSopoClient } from './sopo-client.js';
+// ── Tool Registrations ──────────────────────────────────────────
+import { registerAuthTools } from './tools/auth.tools.js';
+import { registerGatewayTools } from './tools/gateway.tools.js';
+import { registerServiceTools } from './tools/service.tools.js';
+import { registerServiceTargetTools } from './tools/service-target.tools.js';
+import { registerGatewayRouteTools } from './tools/gateway-route.tools.js';
+import { registerGatewayPluginTools } from './tools/gateway-plugin.tools.js';
+import { registerAggregateRequestTools } from './tools/aggregate-request.tools.js';
+import { registerCollectionTools } from './tools/collection.tools.js';
+import { registerUserProfileTools } from './tools/user-profile.tools.js';
+import { registerObservabilityTools } from './tools/observability.tools.js';
+// ── Resource Registrations ──────────────────────────────────────
+import { registerResources } from './resources/platform.resources.js';
+// ── Prompt Registrations ────────────────────────────────────────
+import { registerPrompts } from './prompts/sopo.prompts.js';
+// ═══════════════════════════════════════════════════════════════
+// Configuration
+// ═══════════════════════════════════════════════════════════════
+const BACKEND_URL = process.env.SOPO_BACKEND_URL || 'http://localhost:4000';
+const ACCESS_TOKEN = process.env.SOPO_ACCESS_TOKEN || '';
+if (!ACCESS_TOKEN) {
+    console.error('⚠️  Warning: SOPO_ACCESS_TOKEN is not set. All API calls will fail with 401 Unauthorized.\n' +
+        '   Set it via environment variable or .env file.\n' +
+        '   See .env.example for reference.');
+}
+// ═══════════════════════════════════════════════════════════════
+// Initialize
+// ═══════════════════════════════════════════════════════════════
+// Configure the HTTP client
+configureSopoClient({
+    backendUrl: BACKEND_URL,
+    accessToken: ACCESS_TOKEN,
+});
+// Create the MCP Server
+const server = new McpServer({
+    name: 'sopo-mcp-server',
+    version: '1.0.0',
+    description: 'MCP Server for the Sopo API Gateway Platform — manage gateways, services, routes, plugins, and monitor metrics via AI.',
+});
+// ═══════════════════════════════════════════════════════════════
+// Register All Capabilities
+// ═══════════════════════════════════════════════════════════════
+// Tools — Authentication (login + refresh)
+registerAuthTools(server); // 2 tools: login, refresh_token
+// Tools (30 tools covering full CRUD for all entities + observability)
+registerGatewayTools(server); // 4 tools: list, create, update, delete
+registerServiceTools(server); // 4 tools: list, create, update, delete
+registerServiceTargetTools(server); // 4 tools: list, create, update, delete
+registerGatewayRouteTools(server); // 4 tools: list, create, update, delete
+registerGatewayPluginTools(server); // 4 tools: list, create, update, delete
+registerAggregateRequestTools(server); // 4 tools: list, create, update, delete
+registerCollectionTools(server); // 4 tools: list, create, update, delete
+registerUserProfileTools(server); // 4 tools: get, create, update, delete
+registerObservabilityTools(server); // 5 tools: health, stats, logs, metrics, metrics-mv
+// Resources (3 resources: platform overview, live config, live stats)
+registerResources(server);
+// Prompts (4 prompts: setup gateway, diagnose, full report, add plugin)
+registerPrompts(server);
+// ═══════════════════════════════════════════════════════════════
+// Start Server
+// ═══════════════════════════════════════════════════════════════
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('🚀 Sopo MCP Server started successfully');
+    console.error(`   Backend URL: ${BACKEND_URL}`);
+    console.error(`   Token: ${ACCESS_TOKEN ? '✅ configured' : '❌ missing'}`);
+    console.error(`   Tools: 39 | Resources: 3 | Prompts: 4`);
+}
+main().catch((error) => {
+    console.error('Fatal error starting Sopo MCP Server:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/prompts/sopo.prompts.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Sopo MCP Server — Prompts
+ *
+ * Predefined prompt templates that guide the AI for common Sopo operations.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerPrompts(server: McpServer): void;
+//# sourceMappingURL=sopo.prompts.d.ts.map

package/dist/prompts/sopo.prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sopo.prompts.d.ts","sourceRoot":"","sources":["../../src/prompts/sopo.prompts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsHvD"}