@anton.andrusenko/shopify-mcp-admin 2.1.1 → 2.2.1

package/dist/setup-wizard-PVLOC3DU.js

@@ -0,0 +1,697 @@
+#!/usr/bin/env node
+
+// src/cli/setup-wizard.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { dirname, join } from "path";
+import { confirm, input, password, select } from "@inquirer/prompts";
+var colors = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  // Shopify-inspired colors
+  green: "\x1B[38;5;82m",
+  // Shopify green
+  darkGreen: "\x1B[38;5;34m",
+  cyan: "\x1B[38;5;87m",
+  yellow: "\x1B[38;5;226m",
+  red: "\x1B[38;5;196m",
+  magenta: "\x1B[38;5;207m",
+  blue: "\x1B[38;5;75m",
+  white: "\x1B[38;5;255m",
+  gray: "\x1B[38;5;245m"
+};
+var c = {
+  green: (s) => `${colors.green}${s}${colors.reset}`,
+  darkGreen: (s) => `${colors.darkGreen}${s}${colors.reset}`,
+  cyan: (s) => `${colors.cyan}${s}${colors.reset}`,
+  yellow: (s) => `${colors.yellow}${s}${colors.reset}`,
+  red: (s) => `${colors.red}${s}${colors.reset}`,
+  magenta: (s) => `${colors.magenta}${s}${colors.reset}`,
+  blue: (s) => `${colors.blue}${s}${colors.reset}`,
+  white: (s) => `${colors.white}${s}${colors.reset}`,
+  gray: (s) => `${colors.gray}${s}${colors.reset}`,
+  bold: (s) => `${colors.bold}${s}${colors.reset}`,
+  dim: (s) => `${colors.dim}${s}${colors.reset}`
+};
+function gradientLine(line) {
+  const gradientColors = [
+    "\x1B[38;5;82m",
+    // green
+    "\x1B[38;5;83m",
+    "\x1B[38;5;84m",
+    "\x1B[38;5;85m",
+    "\x1B[38;5;86m",
+    "\x1B[38;5;87m"
+    // cyan
+  ];
+  let result = "";
+  const chars = [...line];
+  for (let i = 0; i < chars.length; i++) {
+    const colorIndex = Math.floor(i / chars.length * gradientColors.length);
+    result += `${gradientColors[colorIndex]}${chars[i]}`;
+  }
+  return result + colors.reset;
+}
+var BANNER = `
+${c.green("\u256D\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256E")}
+${c.green("\u2502")}                                                                      ${c.green("\u2502")}
+${c.green("\u2502")}  ${gradientLine("\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557   \u2588\u2588\u2557")}           ${c.green("\u2502")}
+${c.green("\u2502")}  ${gradientLine("\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u255A\u2588\u2588\u2557 \u2588\u2588\u2554\u255D")}           ${c.green("\u2502")}
+${c.green("\u2502")}  ${gradientLine("\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2557   \u255A\u2588\u2588\u2588\u2588\u2554\u255D ")}           ${c.green("\u2502")}
+${c.green("\u2502")}  ${gradientLine("\u255A\u2550\u2550\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u255D \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u255D    \u255A\u2588\u2588\u2554\u255D  ")}           ${c.green("\u2502")}
+${c.green("\u2502")}  ${gradientLine("\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2551        \u2588\u2588\u2551   ")}           ${c.green("\u2502")}
+${c.green("\u2502")}  ${gradientLine("\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u255D     \u255A\u2550\u255D\u255A\u2550\u255D        \u255A\u2550\u255D   ")}           ${c.green("\u2502")}
+${c.green("\u2502")}                                                                      ${c.green("\u2502")}
+${c.green("\u2502")}                    ${c.bold("MCP ADMIN SERVER")}                                ${c.green("\u2502")}
+${c.green("\u2502")}                                                                      ${c.green("\u2502")}
+${c.green("\u2502")}        ${c.cyan("\u{1F6CD}\uFE0F  Connect AI Agents to Your Shopify Store")}                  ${c.green("\u2502")}
+${c.green("\u2502")}                                                                      ${c.green("\u2502")}
+${c.green("\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256F")}
+`;
+function validateStoreUrl(value) {
+  const trimmed = value.trim().toLowerCase();
+  const cleaned = trimmed.replace(/^https?:\/\//, "");
+  if (!cleaned) {
+    return "Store URL is required";
+  }
+  if (!cleaned.endsWith(".myshopify.com")) {
+    return "Must be a valid myshopify.com domain (e.g., your-store.myshopify.com)";
+  }
+  return true;
+}
+function validateAccessToken(value) {
+  const trimmed = value.trim();
+  if (!trimmed) {
+    return "Access token is required";
+  }
+  if (!trimmed.startsWith("shpat_")) {
+    return 'Access token should start with "shpat_"';
+  }
+  if (trimmed.length < 20) {
+    return "Access token seems too short";
+  }
+  return true;
+}
+function cleanStoreUrl(url) {
+  return url.trim().toLowerCase().replace(/^https?:\/\//, "");
+}
+var Spinner = class {
+  frames = ["\u25D0", "\u25D3", "\u25D1", "\u25D2"];
+  frameIndex = 0;
+  intervalId = null;
+  message;
+  constructor(message) {
+    this.message = message;
+  }
+  start() {
+    process.stdout.write("\x1B[?25l");
+    this.intervalId = setInterval(() => {
+      const frame = this.frames[this.frameIndex];
+      process.stdout.write(`\r${c.cyan(frame)} ${this.message}`);
+      this.frameIndex = (this.frameIndex + 1) % this.frames.length;
+    }, 100);
+  }
+  succeed(message) {
+    this.stop();
+    console.log(`\r${c.green("\u2714")} ${message}`);
+  }
+  fail(message) {
+    this.stop();
+    console.log(`\r${c.red("\u2716")} ${message}`);
+  }
+  stop() {
+    if (this.intervalId) {
+      clearInterval(this.intervalId);
+      this.intervalId = null;
+    }
+    process.stdout.write("\x1B[?25h");
+    process.stdout.write("\r\x1B[K");
+  }
+};
+async function testConnection(config) {
+  const spinner = new Spinner(`Verifying connection to ${config.storeUrl}...`);
+  spinner.start();
+  try {
+    const query = `{
+      shop {
+        name
+        plan { displayName }
+        email
+      }
+    }`;
+    let accessToken = config.accessToken;
+    if (config.authMethod === "oauth" && config.clientId && config.clientSecret) {
+      const tokenResponse = await fetch(`https://${config.storeUrl}/admin/oauth/access_token`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          grant_type: "client_credentials",
+          client_id: config.clientId,
+          client_secret: config.clientSecret
+        })
+      });
+      if (!tokenResponse.ok) {
+        spinner.fail("Failed to authenticate with OAuth credentials");
+        return null;
+      }
+      const tokenData = await tokenResponse.json();
+      accessToken = tokenData.access_token;
+    }
+    const response = await fetch(`https://${config.storeUrl}/admin/api/2025-01/graphql.json`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-Shopify-Access-Token": accessToken || ""
+      },
+      body: JSON.stringify({ query })
+    });
+    if (!response.ok) {
+      if (response.status === 401) {
+        spinner.fail("Authentication failed - check your access token");
+      } else if (response.status === 403) {
+        spinner.fail("Access denied - check API scopes");
+      } else {
+        spinner.fail(`Connection failed (HTTP ${response.status})`);
+      }
+      return null;
+    }
+    const data = await response.json();
+    if (data.errors) {
+      spinner.fail(`API error: ${data.errors[0]?.message || "Unknown error"}`);
+      return null;
+    }
+    if (!data.data) {
+      spinner.fail("Invalid response from Shopify API");
+      return null;
+    }
+    const storeInfo = {
+      name: data.data.shop.name,
+      plan: data.data.shop.plan.displayName,
+      email: data.data.shop.email
+    };
+    spinner.succeed(`Connected! Store: "${storeInfo.name}" (${storeInfo.plan})`);
+    return storeInfo;
+  } catch (error) {
+    spinner.fail(`Connection error: ${error instanceof Error ? error.message : "Unknown error"}`);
+    return null;
+  }
+}
+function buildEnvVars(config) {
+  const env = {
+    SHOPIFY_STORE_URL: config.storeUrl
+  };
+  if (config.authMethod === "token" && config.accessToken) {
+    env.SHOPIFY_ACCESS_TOKEN = config.accessToken;
+  } else {
+    env.SHOPIFY_CLIENT_ID = config.clientId || "";
+    env.SHOPIFY_CLIENT_SECRET = config.clientSecret || "";
+  }
+  if (config.lazyLoading) {
+    env.SHOPIFY_MCP_LAZY_LOADING = "true";
+  } else if (config.role) {
+    env.SHOPIFY_MCP_ROLE = config.role;
+  }
+  if (config.transport === "http") {
+    env.TRANSPORT = "http";
+    env.PORT = String(config.port || 3e3);
+  }
+  return env;
+}
+function generateJsonConfig(config) {
+  const env = buildEnvVars(config);
+  const mcpConfig = {
+    mcpServers: {
+      shopify: {
+        command: "npx",
+        args: ["-y", "@anton.andrusenko/shopify-mcp-admin"],
+        env
+      }
+    }
+  };
+  return JSON.stringify(mcpConfig, null, 2);
+}
+function generateLibreChatConfig(config) {
+  const env = buildEnvVars(config);
+  const envLines = Object.entries(env).map(([key, value]) => `      ${key}: "${value}"`).join("\n");
+  return `# LibreChat Configuration for Shopify MCP Admin
+# Generated by shopify-mcp-admin setup wizard
+# Docs: https://github.com/AntonAndrusenko/shopify-mcp-admin
+
+version: 1.2.1
+cache: true
+
+interface:
+  customWelcome: 'Welcome to LibreChat with Shopify MCP! \u{1F6CD}\uFE0F'
+
+mcpServers:
+  shopify:
+    type: ${config.transport === "http" ? "sse" : "stdio"}
+    ${config.transport === "http" ? `url: http://localhost:${config.port || 3e3}/sse` : `command: npx
+    args:
+      - -y
+      - "@anton.andrusenko/shopify-mcp-admin"`}
+    env:
+${envLines}
+      LOG_LEVEL: "info"
+    serverInstructions: true
+    timeout: 30000
+    initTimeout: 15000
+`;
+}
+function generateEnvFile(config) {
+  const env = buildEnvVars(config);
+  let content = `# Shopify MCP Admin Configuration
+# Generated by shopify-mcp-admin setup wizard
+# Docs: https://github.com/AntonAndrusenko/shopify-mcp-admin
+
+`;
+  for (const [key, value] of Object.entries(env)) {
+    content += `${key}=${value}
+`;
+  }
+  return content;
+}
+function generateShellExport(config) {
+  const env = buildEnvVars(config);
+  let content = `# Shopify MCP Admin - Shell Environment
+# Add to your ~/.bashrc, ~/.zshrc, or run: source <filename>
+
+`;
+  for (const [key, value] of Object.entries(env)) {
+    content += `export ${key}="${value}"
+`;
+  }
+  content += `
+# Run the server with:
+# npx @anton.andrusenko/shopify-mcp-admin
+`;
+  return content;
+}
+function getClaudeDesktopConfigPath() {
+  const platform = process.platform;
+  if (platform === "darwin") {
+    return join(
+      homedir(),
+      "Library",
+      "Application Support",
+      "Claude",
+      "claude_desktop_config.json"
+    );
+  }
+  if (platform === "win32") {
+    return join(process.env.APPDATA || "", "Claude", "claude_desktop_config.json");
+  }
+  return join(homedir(), ".config", "claude", "claude_desktop_config.json");
+}
+function getCursorConfigPath() {
+  return join(process.cwd(), ".cursor", "mcp.json");
+}
+function getWindsurfConfigPath() {
+  const platform = process.platform;
+  if (platform === "darwin") {
+    return join(homedir(), ".codeium", "windsurf", "mcp_config.json");
+  }
+  if (platform === "win32") {
+    return join(process.env.APPDATA || "", "Codeium", "windsurf", "mcp_config.json");
+  }
+  return join(homedir(), ".codeium", "windsurf", "mcp_config.json");
+}
+function getVSCodeConfigPath() {
+  return join(process.cwd(), ".vscode", "mcp.json");
+}
+function ensureDirectoryExists(filePath) {
+  const dir = dirname(filePath);
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+}
+function mergeJsonConfig(existingPath, newConfig) {
+  if (!existsSync(existingPath)) {
+    return newConfig;
+  }
+  try {
+    const existing = JSON.parse(readFileSync(existingPath, "utf-8"));
+    const toMerge = JSON.parse(newConfig);
+    existing.mcpServers = {
+      ...existing.mcpServers,
+      ...toMerge.mcpServers
+    };
+    return JSON.stringify(existing, null, 2);
+  } catch {
+    return newConfig;
+  }
+}
+function printSuccessBox(client, configPath) {
+  const lines = ["", `   ${c.green("\u2728")} ${c.bold("You're all set!")}`, ""];
+  lines.push(`   ${c.cyan("Next steps:")}`);
+  switch (client) {
+    case "claude-desktop":
+      lines.push("   1. Restart Claude Desktop");
+      lines.push(`   2. Look for "shopify" in the MCP servers list`);
+      lines.push(`   3. Try: "List all products in my store"`);
+      break;
+    case "cursor":
+      lines.push("   1. Restart Cursor");
+      lines.push("   2. The Shopify MCP server will be available");
+      lines.push(`   3. Try: "List all products in my Shopify store"`);
+      break;
+    case "windsurf":
+      lines.push("   1. Restart Windsurf");
+      lines.push(`   2. Look for "shopify" in the Cascade MCP list`);
+      lines.push(`   3. Try: "List all products in my store"`);
+      break;
+    case "vscode-copilot":
+      lines.push("   1. Restart VS Code");
+      lines.push(`   2. Use Copilot Chat with "shopify" MCP`);
+      lines.push("   3. Try: @shopify list products");
+      break;
+    case "librechat":
+      lines.push("   1. Copy librechat.yaml to your LibreChat directory");
+      lines.push("   2. Restart LibreChat: docker compose restart");
+      lines.push(`   3. Select "shopify" in the MCP servers dropdown`);
+      break;
+    case "openai-http":
+      lines.push("   1. Start the server: npx @anton.andrusenko/shopify-mcp-admin");
+      lines.push("   2. Server will listen on the configured port");
+      lines.push("   3. Connect your OpenAI integration via HTTP");
+      break;
+    case "other":
+      lines.push(`   1. Source the env file: source ${configPath}`);
+      lines.push("   2. Or copy variables to your shell profile");
+      lines.push("   3. Run: npx @anton.andrusenko/shopify-mcp-admin");
+      break;
+  }
+  lines.push("");
+  lines.push(
+    `   ${c.gray("\u{1F4DA} Docs:")} ${c.cyan("https://github.com/AntonAndrusenko/shopify-mcp-admin")}`
+  );
+  lines.push("");
+  const maxLength = 65;
+  const boxTop = c.green(`\u256D${"\u2500".repeat(maxLength)}\u256E`);
+  const boxBottom = c.green(`\u2570${"\u2500".repeat(maxLength)}\u256F`);
+  console.log("");
+  console.log(boxTop);
+  const ansiRegex = /\x1b\[[0-9;]*m/g;
+  for (const line of lines) {
+    const visibleLength = line.replace(ansiRegex, "").length;
+    const padding = maxLength - visibleLength;
+    console.log(`${c.green("\u2502")}${line}${" ".repeat(Math.max(0, padding))}${c.green("\u2502")}`);
+  }
+  console.log(boxBottom);
+  console.log("");
+}
+async function runSetupWizard() {
+  console.clear();
+  console.log(BANNER);
+  const config = {
+    storeUrl: "",
+    authMethod: "token",
+    transport: "stdio",
+    lazyLoading: false,
+    client: "claude-desktop"
+  };
+  try {
+    console.log("");
+    const storeUrlInput = await input({
+      message: "What is your Shopify store URL?",
+      default: "your-store.myshopify.com",
+      validate: validateStoreUrl,
+      transformer: (value) => cleanStoreUrl(value)
+    });
+    config.storeUrl = cleanStoreUrl(storeUrlInput);
+    console.log("");
+    config.authMethod = await select({
+      message: "How would you like to authenticate?",
+      choices: [
+        {
+          name: "Access Token (Legacy Custom App)",
+          value: "token",
+          description: "I have a shpat_xxx token from a Custom App"
+        },
+        {
+          name: "OAuth 2.0 (Dev Dashboard)",
+          value: "oauth",
+          description: "I have a Client ID and Client Secret"
+        }
+      ]
+    });
+    console.log("");
+    if (config.authMethod === "token") {
+      config.accessToken = await password({
+        message: "Paste your access token (shpat_xxx)",
+        mask: "\u2022",
+        validate: validateAccessToken
+      });
+    } else {
+      config.clientId = await input({
+        message: "Enter your Client ID",
+        validate: (v) => v.trim().length > 0 || "Client ID is required"
+      });
+      config.clientSecret = await password({
+        message: "Enter your Client Secret",
+        mask: "\u2022",
+        validate: (v) => v.trim().length > 0 || "Client Secret is required"
+      });
+    }
+    console.log("");
+    const storeInfo = await testConnection(config);
+    if (!storeInfo) {
+      const retry = await confirm({
+        message: "Connection failed. Would you like to try different credentials?",
+        default: true
+      });
+      if (retry) {
+        return runSetupWizard();
+      }
+      console.log(c.yellow("\nSetup cancelled. Please check your credentials and try again."));
+      process.exit(1);
+    }
+    console.log("");
+    config.client = await select({
+      message: "Which AI client will you use?",
+      choices: [
+        {
+          name: "Claude Desktop",
+          value: "claude-desktop",
+          description: "Anthropic's official Claude app"
+        },
+        {
+          name: "Cursor",
+          value: "cursor",
+          description: "AI-powered code editor"
+        },
+        {
+          name: "Windsurf",
+          value: "windsurf",
+          description: "Codeium AI IDE with Cascade"
+        },
+        {
+          name: "VS Code (Copilot)",
+          value: "vscode-copilot",
+          description: "VS Code with GitHub Copilot MCP"
+        },
+        {
+          name: "LibreChat",
+          value: "librechat",
+          description: "Open-source chat UI (Docker)"
+        },
+        {
+          name: "OpenAI / HTTP Integration",
+          value: "openai-http",
+          description: "HTTP server for OpenAI function calling"
+        },
+        {
+          name: "Other / Manual Setup",
+          value: "other",
+          description: "Generate shell exports for manual configuration"
+        }
+      ]
+    });
+    console.log("");
+    const loadingStrategy = await select({
+      message: "How would you like to load tools?",
+      choices: [
+        {
+          name: `Load all tools at startup ${c.dim("(recommended)")}`,
+          value: "all",
+          description: "All 79 tools immediately available - best for most users"
+        },
+        {
+          name: `Load by role preset ${c.dim("(optimized)")}`,
+          value: "role",
+          description: "Load tools based on your workflow - reduces AI token usage"
+        },
+        {
+          name: `Lazy loading ${c.dim("(on-demand)")}`,
+          value: "lazy",
+          description: '15 core tools at start, load more with "load-module" command'
+        }
+      ]
+    });
+    if (loadingStrategy === "lazy") {
+      config.lazyLoading = true;
+      console.log(
+        c.gray('  \u2139\uFE0F  Lazy loading: Use "list-modules" and "load-module" tools to add more tools')
+      );
+    } else if (loadingStrategy === "role") {
+      console.log("");
+      const roleChoice = await select({
+        message: "Select your role preset:",
+        choices: [
+          {
+            name: `Product Manager ${c.dim("(41 tools)")}`,
+            value: "product-manager",
+            description: "Products, inventory, collections, and metafields"
+          },
+          {
+            name: `Content Manager ${c.dim("(37 tools)")}`,
+            value: "content-manager",
+            description: "Pages, blogs, articles, and SEO content"
+          },
+          {
+            name: `International Manager ${c.dim("(46 tools)")}`,
+            value: "international-manager",
+            description: "Markets, locales, and translations"
+          },
+          {
+            name: `SEO Specialist ${c.dim("(38 tools)")}`,
+            value: "seo-specialist",
+            description: "SEO optimization, redirects, and URL management"
+          },
+          {
+            name: `Inventory Manager ${c.dim("(15 tools)")}`,
+            value: "inventory-manager",
+            description: "Core product and inventory tools only"
+          }
+        ]
+      });
+      config.role = roleChoice;
+    }
+    if (config.client === "librechat" || config.client === "openai-http" || config.client === "other") {
+      console.log("");
+      config.transport = await select({
+        message: "Which transport mode?",
+        default: config.client === "openai-http" ? "http" : "stdio",
+        choices: [
+          {
+            name: `STDIO ${c.dim("(recommended for most clients)")}`,
+            value: "stdio",
+            description: "Standard input/output communication"
+          },
+          {
+            name: `HTTP ${c.dim("(for web integrations)")}`,
+            value: "http",
+            description: "HTTP server with SSE support"
+          }
+        ]
+      });
+      if (config.transport === "http") {
+        const portInput = await input({
+          message: "HTTP server port",
+          default: "3000",
+          validate: (v) => {
+            const n = Number.parseInt(v, 10);
+            return n > 0 && n < 65536 || "Must be a valid port number";
+          }
+        });
+        config.port = Number.parseInt(portInput, 10);
+      }
+    }
+    if (config.client === "openai-http") {
+      config.transport = "http";
+      config.port = config.port || 3e3;
+    }
+    console.log("");
+    let configContent;
+    let configPath;
+    let configDescription;
+    switch (config.client) {
+      case "claude-desktop": {
+        configPath = getClaudeDesktopConfigPath();
+        configContent = generateJsonConfig(config);
+        configContent = mergeJsonConfig(configPath, configContent);
+        configDescription = "Claude Desktop config";
+        break;
+      }
+      case "cursor": {
+        configPath = getCursorConfigPath();
+        configContent = generateJsonConfig(config);
+        configContent = mergeJsonConfig(configPath, configContent);
+        configDescription = "Cursor MCP config";
+        break;
+      }
+      case "windsurf": {
+        configPath = getWindsurfConfigPath();
+        configContent = generateJsonConfig(config);
+        configContent = mergeJsonConfig(configPath, configContent);
+        configDescription = "Windsurf MCP config";
+        break;
+      }
+      case "vscode-copilot": {
+        configPath = getVSCodeConfigPath();
+        configContent = generateJsonConfig(config);
+        configContent = mergeJsonConfig(configPath, configContent);
+        configDescription = "VS Code MCP config";
+        break;
+      }
+      case "librechat": {
+        configPath = join(process.cwd(), "librechat.yaml");
+        configContent = generateLibreChatConfig(config);
+        configDescription = "LibreChat config";
+        break;
+      }
+      case "openai-http": {
+        configPath = join(process.cwd(), ".env.shopify-mcp");
+        configContent = generateEnvFile(config);
+        configDescription = "Environment file (HTTP mode)";
+        break;
+      }
+      default: {
+        configPath = join(process.cwd(), ".shopify-mcp.env");
+        configContent = generateShellExport(config);
+        configDescription = "Shell environment exports";
+        break;
+      }
+    }
+    console.log(c.cyan(`
+\u{1F4C4} ${configDescription} preview:
+`));
+    console.log(c.gray("\u2500".repeat(60)));
+    console.log(c.dim(configContent));
+    console.log(c.gray("\u2500".repeat(60)));
+    const shouldSave = await confirm({
+      message: `Save to ${configPath}?`,
+      default: true
+    });
+    if (shouldSave) {
+      ensureDirectoryExists(configPath);
+      writeFileSync(configPath, configContent, "utf-8");
+      console.log(`
+${c.green("\u2714")} Configuration saved to: ${c.cyan(configPath)}`);
+    } else {
+      console.log(`
+${c.yellow("\u2139")} Configuration not saved. You can copy the preview above.`);
+    }
+    printSuccessBox(config.client, configPath);
+  } catch (error) {
+    if (error instanceof Error && error.name === "ExitPromptError") {
+      console.log(c.yellow("\n\nSetup cancelled."));
+      process.exit(0);
+    }
+    throw error;
+  }
+}
+function isSetupCommand(args) {
+  return args.includes("init") || args.includes("setup") || args.includes("--setup");
+}
+if (process.argv[1]?.includes("setup-wizard")) {
+  runSetupWizard().catch((error) => {
+    console.error(c.red("Setup failed:"), error);
+    process.exit(1);
+  });
+}
+export {
+  isSetupCommand,
+  runSetupWizard
+};