swagmanager-mcp 1.0.0 → 1.2.0

package/bin/swagmanager-mcp.js

@@ -4,14 +4,13 @@
  * SwagManager MCP Server CLI
  *
  * Usage:
- *   npx @swagmanager/mcp
- *   swagmanager-mcp
+ *   npx swagmanager-mcp          — Run the MCP server (stdio)
+ *   npx swagmanager-mcp setup    — Install to Claude Code, Cursor, etc.
  *
  * Environment variables:
  *   SUPABASE_URL              - Your Supabase project URL
  *   SUPABASE_SERVICE_ROLE_KEY - Your Supabase service role key
  *   STORE_ID                  - Default store ID (optional)
- *   SWAG_API_KEY              - API key for auth (future)
  */
 
 import { fileURLToPath } from "url";
@@ -20,6 +19,11 @@ import { dirname, join } from "path";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
-// Import and run the server
-const serverPath = join(__dirname, "..", "dist", "index.js");
-await import(serverPath);
+const command = process.argv[2];
+
+if (command === "setup") {
+  const { runSetup } = await import(join(__dirname, "..", "dist", "setup.js"));
+  await runSetup();
+} else {
+  await import(join(__dirname, "..", "dist", "index.js"));
+}

package/dist/index.js

@@ -14,6 +14,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { createClient } from "@supabase/supabase-js";
 import { executeTool, getImplementedTools } from "./tools/executor.js";
+import { startUpdateLoop } from "./updater.js";
 // ============================================================================
 // CONFIGURATION
 // ============================================================================
@@ -130,6 +131,8 @@ async function main() {
     // Pre-load tools
     const tools = await loadToolDefinitions(true);
     console.error(`[MCP] Loaded ${tools.length} tools`);
+    // Start OTA update checker (non-blocking, runs in background)
+    startUpdateLoop(true);
     // Connect via stdio
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/dist/setup.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * SwagManager MCP — Interactive Setup
+ *
+ * Detects installed MCP-compatible CLIs and writes config for each.
+ * Usage: npx swagmanager-mcp setup
+ */
+export declare function runSetup(): Promise<void>;

package/dist/setup.js

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+/**
+ * SwagManager MCP — Interactive Setup
+ *
+ * Detects installed MCP-compatible CLIs and writes config for each.
+ * Usage: npx swagmanager-mcp setup
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { dirname, join } from "path";
+import { createInterface } from "readline";
+const home = homedir();
+const CLI_TARGETS = [
+    {
+        name: "Claude Code",
+        configPath: join(home, ".claude", "settings.json"),
+        configKey: "mcpServers",
+        detect: () => existsSync(join(home, ".claude")),
+        format: (servers) => servers,
+    },
+    {
+        name: "Claude Desktop",
+        configPath: process.platform === "darwin"
+            ? join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json")
+            : join(home, "AppData", "Roaming", "Claude", "claude_desktop_config.json"),
+        configKey: "mcpServers",
+        detect: () => existsSync(process.platform === "darwin"
+            ? join(home, "Library", "Application Support", "Claude")
+            : join(home, "AppData", "Roaming", "Claude")),
+        format: (servers) => servers,
+    },
+    {
+        name: "Cursor",
+        configPath: join(home, ".cursor", "mcp.json"),
+        configKey: "mcpServers",
+        detect: () => existsSync(join(home, ".cursor")),
+        format: (servers) => servers,
+    },
+    {
+        name: "Windsurf",
+        configPath: join(home, ".codeium", "windsurf", "mcp_config.json"),
+        configKey: "mcpServers",
+        detect: () => existsSync(join(home, ".codeium", "windsurf")),
+        format: (servers) => servers,
+    },
+    {
+        name: "Gemini CLI",
+        configPath: join(home, ".gemini", "settings.json"),
+        configKey: "mcpServers",
+        detect: () => existsSync(join(home, ".gemini")),
+        format: (servers) => servers,
+    },
+];
+// ============================================================================
+// HELPERS
+// ============================================================================
+function readJSON(path) {
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+function writeJSON(path, data) {
+    const dir = dirname(path);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(path, JSON.stringify(data, null, 2) + "\n", "utf-8");
+}
+function prompt(rl, question, defaultValue) {
+    const suffix = defaultValue ? ` (${defaultValue})` : "";
+    return new Promise((resolve) => {
+        rl.question(`${question}${suffix}: `, (answer) => {
+            resolve(answer.trim() || defaultValue || "");
+        });
+    });
+}
+function promptYN(rl, question, defaultYes = true) {
+    const hint = defaultYes ? "[Y/n]" : "[y/N]";
+    return new Promise((resolve) => {
+        rl.question(`${question} ${hint} `, (answer) => {
+            const a = answer.trim().toLowerCase();
+            if (a === "")
+                resolve(defaultYes);
+            else
+                resolve(a === "y" || a === "yes");
+        });
+    });
+}
+// ============================================================================
+// MAIN
+// ============================================================================
+export async function runSetup() {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    console.log("");
+    console.log("  SwagManager MCP — Setup");
+    console.log("  ═══════════════════════");
+    console.log("");
+    // Detect installed CLIs
+    const detected = CLI_TARGETS.filter((t) => t.detect());
+    const notDetected = CLI_TARGETS.filter((t) => !t.detect());
+    if (detected.length > 0) {
+        console.log("  Detected CLIs:");
+        detected.forEach((t) => console.log(`    + ${t.name}`));
+    }
+    if (notDetected.length > 0) {
+        console.log("  Not found:");
+        notDetected.forEach((t) => console.log(`    - ${t.name}`));
+    }
+    console.log("");
+    if (detected.length === 0) {
+        console.log("  No supported MCP clients detected.");
+        console.log("  Install Claude Code, Claude Desktop, Cursor, Windsurf, or Gemini CLI first.");
+        rl.close();
+        return;
+    }
+    // Collect credentials
+    console.log("  Enter your Supabase credentials:");
+    console.log("");
+    const supabaseUrl = await prompt(rl, "  Supabase URL");
+    if (!supabaseUrl) {
+        console.log("  Supabase URL is required. Aborting.");
+        rl.close();
+        return;
+    }
+    const supabaseKey = await prompt(rl, "  Supabase Service Role Key");
+    if (!supabaseKey) {
+        console.log("  Service Role Key is required. Aborting.");
+        rl.close();
+        return;
+    }
+    const storeId = await prompt(rl, "  Store ID (optional, press enter to skip)");
+    console.log("");
+    // Build MCP server entry
+    const serverEntry = {
+        type: "stdio",
+        command: "npx",
+        args: ["-y", "swagmanager-mcp"],
+        env: {
+            SUPABASE_URL: supabaseUrl,
+            SUPABASE_SERVICE_ROLE_KEY: supabaseKey,
+            ...(storeId ? { STORE_ID: storeId } : {}),
+        },
+    };
+    // Install to each detected CLI
+    let installed = 0;
+    for (const target of detected) {
+        const install = await promptYN(rl, `  Install to ${target.name}?`);
+        if (!install)
+            continue;
+        const config = readJSON(target.configPath);
+        if (!config[target.configKey])
+            config[target.configKey] = {};
+        // Check for existing entry
+        if (config[target.configKey].swagmanager) {
+            const overwrite = await promptYN(rl, `    swagmanager already configured in ${target.name}. Overwrite?`, false);
+            if (!overwrite)
+                continue;
+        }
+        config[target.configKey].swagmanager = target.format(serverEntry);
+        writeJSON(target.configPath, config);
+        console.log(`    Wrote ${target.configPath}`);
+        installed++;
+    }
+    console.log("");
+    if (installed > 0) {
+        console.log(`  Done! Installed to ${installed} CLI${installed > 1 ? "s" : ""}.`);
+        console.log("  Restart your CLI(s) to load the MCP server.");
+    }
+    else {
+        console.log("  No changes made.");
+    }
+    console.log("");
+    rl.close();
+}
+// Run if called directly
+const isDirectRun = process.argv[1]?.includes("setup");
+if (isDirectRun) {
+    runSetup().catch(console.error);
+}

package/dist/updater.d.ts

@@ -0,0 +1,25 @@
+/**
+ * OTA Auto-Updater for SwagManager MCP Server
+ *
+ * Checks the npm registry for newer versions and self-updates.
+ * - Runs on server startup (non-blocking)
+ * - Runs periodically (default: every 4 hours)
+ * - Updates in-place via `npm install -g` or local install
+ * - Signals the process to restart after update
+ */
+export interface UpdateCheckResult {
+    currentVersion: string;
+    latestVersion: string | null;
+    updateAvailable: boolean;
+    updated: boolean;
+}
+/**
+ * Check for updates and install if available.
+ * Returns the result without restarting — caller decides restart behavior.
+ */
+export declare function checkForUpdates(autoInstall?: boolean): Promise<UpdateCheckResult>;
+/**
+ * Start periodic update checks in the background.
+ * First check runs immediately (non-blocking), then every CHECK_INTERVAL_MS.
+ */
+export declare function startUpdateLoop(autoInstall?: boolean): NodeJS.Timeout;

package/dist/updater.js

@@ -0,0 +1,140 @@
+/**
+ * OTA Auto-Updater for SwagManager MCP Server
+ *
+ * Checks the npm registry for newer versions and self-updates.
+ * - Runs on server startup (non-blocking)
+ * - Runs periodically (default: every 4 hours)
+ * - Updates in-place via `npm install -g` or local install
+ * - Signals the process to restart after update
+ */
+import { execFile } from "child_process";
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import https from "https";
+// ============================================================================
+// CONFIG
+// ============================================================================
+const PACKAGE_NAME = "swagmanager-mcp";
+const CHECK_INTERVAL_MS = 4 * 60 * 60 * 1000; // 4 hours
+const REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
+// ============================================================================
+// HELPERS
+// ============================================================================
+function getCurrentVersion() {
+    try {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = dirname(__filename);
+        const pkgPath = join(__dirname, "..", "package.json");
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+        return pkg.version || "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+function parseVersion(v) {
+    return v.replace(/^v/, "").split(".").map(Number);
+}
+function isNewer(remote, local) {
+    const r = parseVersion(remote);
+    const l = parseVersion(local);
+    for (let i = 0; i < 3; i++) {
+        if ((r[i] || 0) > (l[i] || 0))
+            return true;
+        if ((r[i] || 0) < (l[i] || 0))
+            return false;
+    }
+    return false;
+}
+function fetchLatestVersion() {
+    return new Promise((resolve) => {
+        const req = https.get(REGISTRY_URL, { timeout: 10_000 }, (res) => {
+            let body = "";
+            res.on("data", (chunk) => (body += chunk.toString()));
+            res.on("end", () => {
+                try {
+                    const data = JSON.parse(body);
+                    resolve({
+                        version: data.version,
+                        changelog: data.changelog || data.description,
+                    });
+                }
+                catch {
+                    resolve(null);
+                }
+            });
+        });
+        req.on("error", () => resolve(null));
+        req.on("timeout", () => {
+            req.destroy();
+            resolve(null);
+        });
+    });
+}
+function runNpmInstall(version) {
+    return new Promise((resolve) => {
+        const args = ["install", "-g", `${PACKAGE_NAME}@${version}`];
+        console.error(`[updater] Running: npm ${args.join(" ")}`);
+        execFile("npm", args, { timeout: 120_000 }, (error, stdout, stderr) => {
+            if (error) {
+                console.error(`[updater] Install failed: ${error.message}`);
+                if (stderr)
+                    console.error(`[updater] stderr: ${stderr}`);
+                resolve(false);
+            }
+            else {
+                console.error(`[updater] Install succeeded`);
+                if (stdout)
+                    console.error(`[updater] ${stdout.trim()}`);
+                resolve(true);
+            }
+        });
+    });
+}
+/**
+ * Check for updates and install if available.
+ * Returns the result without restarting — caller decides restart behavior.
+ */
+export async function checkForUpdates(autoInstall = true) {
+    const currentVersion = getCurrentVersion();
+    const latest = await fetchLatestVersion();
+    if (!latest) {
+        console.error(`[updater] Could not reach npm registry (offline?)`);
+        return { currentVersion, latestVersion: null, updateAvailable: false, updated: false };
+    }
+    const updateAvailable = isNewer(latest.version, currentVersion);
+    if (!updateAvailable) {
+        console.error(`[updater] Up to date (v${currentVersion})`);
+        return { currentVersion, latestVersion: latest.version, updateAvailable: false, updated: false };
+    }
+    console.error(`[updater] Update available: v${currentVersion} → v${latest.version}`);
+    if (!autoInstall) {
+        return { currentVersion, latestVersion: latest.version, updateAvailable: true, updated: false };
+    }
+    const installed = await runNpmInstall(latest.version);
+    if (installed) {
+        console.error(`[updater] Updated to v${latest.version}. Restart to use new version.`);
+    }
+    return {
+        currentVersion,
+        latestVersion: latest.version,
+        updateAvailable: true,
+        updated: installed,
+    };
+}
+/**
+ * Start periodic update checks in the background.
+ * First check runs immediately (non-blocking), then every CHECK_INTERVAL_MS.
+ */
+export function startUpdateLoop(autoInstall = true) {
+    // Initial check (fire-and-forget)
+    checkForUpdates(autoInstall).catch(() => { });
+    // Periodic checks
+    const timer = setInterval(() => {
+        checkForUpdates(autoInstall).catch(() => { });
+    }, CHECK_INTERVAL_MS);
+    // Don't prevent process exit
+    timer.unref();
+    return timer;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "swagmanager-mcp",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "SwagManager MCP Server — manage inventory, orders, analytics, and more from Claude Code/Desktop",
   "type": "module",
   "main": "dist/index.js",
@@ -30,6 +30,14 @@
     "bin",
     "README.md"
   ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/floradistro/whale-mcp.git"
+  },
+  "author": "Flora Distribution",
   "keywords": [
     "mcp",
     "claude",