wowstore-mcp 1.0.0

package/README.md

@@ -0,0 +1,77 @@
+# WowStore MCP Server
+
+> Connect AI assistants to WowStore.live — European fashion with 2,200+ products from 40+ EU brands
+
+Lucy's Commerce Brain enables AI assistants like Claude, ChatGPT, and Cursor to search products, get styling advice, browse collections, create shopping carts, and check discounts on [WowStore.live](https://wowstore.live).
+
+## Quick Start
+
+### Option 1: Claude Desktop / Cursor
+
+Add to your MCP config:
+
+```json
+{
+  "mcpServers": {
+    "wowstore": {
+      "command": "npx",
+      "args": ["@wowstore/mcp"]
+    }
+  }
+}
+```
+
+### Option 2: Direct SSE Connection
+
+```
+https://ai-api.wowstore.live/mcp/sse
+```
+
+### Option 3: REST API
+
+```bash
+# Search products
+curl https://ai-api.wowstore.live/api/mcp/search?q=dress
+
+# Get store info
+curl https://ai-api.wowstore.live/api/mcp/store
+
+# Check discounts
+curl https://ai-api.wowstore.live/api/mcp/discounts
+```
+
+## Available Tools (10)
+
+| Tool | Description |
+|------|-------------|
+| `search_products` | Search 2,200+ products by keyword |
+| `get_product` | Full product details — sizes, colors, images |
+| `browse_collection` | Browse curated collections |
+| `list_collections` | List all product categories |
+| `get_store_info` | Shipping, returns, payments, features |
+| `create_cart` | Build a cart, get checkout URL |
+| `ask_lucy` | Ask Lucy AI stylist for fashion advice |
+| `get_recommendations` | Similar & complementary suggestions |
+| `check_discount` | Active promo codes and offers |
+| `create_capsule` | Build a capsule wardrobe |
+
+## About WowStore
+
+WowStore.live is a curated European fashion marketplace based in the Netherlands. Features include:
+
+- **Lucy AI Stylist** — Personalized fashion guidance
+- **Mix & Match Studio** — Build outfits with AI images
+- **Creator Economy** — Earn from sharing your style
+- **Free EU shipping** over EUR 69
+- **14-day returns** (EU consumer rights)
+- **Payments**: iDEAL, Klarna, PayPal, Apple Pay, Google Pay
+
+## Links
+
+- Store: [wowstore.live](https://wowstore.live)
+- MCP Info: [ai-api.wowstore.live/mcp-info](https://ai-api.wowstore.live/mcp-info)
+- MCP Manifest: [ai-api.wowstore.live/.well-known/mcp.json](https://ai-api.wowstore.live/.well-known/mcp.json)
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+/**
+ * WowStore MCP Server — Lucy's Commerce Brain
+ *
+ * Connects AI assistants (Claude, ChatGPT, etc.) to WowStore.live
+ * European fashion store with 2,200+ products from 40+ EU brands.
+ *
+ * Usage:
+ *   npx @wowstore/mcp          # Start proxy to hosted server
+ *   npx @wowstore/mcp --info   # Show server info
+ *
+ * MCP Config (Claude Desktop / Cursor / etc.):
+ *   {
+ *     "mcpServers": {
+ *       "wowstore": {
+ *         "command": "npx",
+ *         "args": ["@wowstore/mcp"]
+ *       }
+ *     }
+ *   }
+ *
+ * Or connect directly via SSE:
+ *   https://ai-api.wowstore.live/mcp/sse
+ */
+
+const MCP_SSE_URL = "https://ai-api.wowstore.live/mcp/sse";
+const MCP_MESSAGES_URL = "https://ai-api.wowstore.live/mcp/messages";
+const MCP_INFO_URL = "https://ai-api.wowstore.live/mcp-info";
+
+async function showInfo() {
+  try {
+    const res = await fetch(MCP_INFO_URL);
+    const info = await res.json();
+    console.log("\n🛍️  WowStore MCP Server — Lucy's Commerce Brain\n");
+    console.log(`   ${info.description}\n`);
+    console.log("   Tools:");
+    for (const tool of info.tools) {
+      console.log(`     • ${tool}`);
+    }
+    console.log(`\n   SSE Endpoint: ${MCP_SSE_URL}`);
+    console.log(`   REST API:     ${info.rest_api}`);
+    console.log(`   Store:        ${info.store}`);
+    console.log(`\n   Add to Claude Desktop / Cursor:`);
+    console.log(`   {`);
+    console.log(`     "mcpServers": {`);
+    console.log(`       "wowstore": {`);
+    console.log(`         "command": "npx",`);
+    console.log(`         "args": ["@wowstore/mcp"]`);
+    console.log(`       }`);
+    console.log(`     }`);
+    console.log(`   }\n`);
+  } catch (e) {
+    console.error("Failed to reach WowStore MCP server:", e.message);
+    process.exit(1);
+  }
+}
+
+// STDIO-to-SSE bridge for MCP protocol
+async function startStdioBridge() {
+  const readline = await import("readline");
+
+  const rl = readline.createInterface({ input: process.stdin });
+
+  // Read JSON-RPC messages from stdin, forward to hosted server
+  rl.on("line", async (line) => {
+    try {
+      const message = JSON.parse(line);
+
+      // Forward to hosted MCP server
+      const res = await fetch(MCP_MESSAGES_URL, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(message),
+      });
+
+      const response = await res.json();
+
+      // Write response to stdout
+      process.stdout.write(JSON.stringify(response) + "\n");
+    } catch (e) {
+      const errorResponse = {
+        jsonrpc: "2.0",
+        id: null,
+        error: { code: -32603, message: `Bridge error: ${e.message}` },
+      };
+      process.stdout.write(JSON.stringify(errorResponse) + "\n");
+    }
+  });
+
+  rl.on("close", () => process.exit(0));
+}
+
+// Main
+const args = process.argv.slice(2);
+
+if (args.includes("--info") || args.includes("-i") || args.includes("--help")) {
+  showInfo();
+} else {
+  // Default: run as STDIO bridge for MCP clients
+  startStdioBridge();
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "wowstore-mcp",
+  "version": "1.0.0",
+  "description": "WowStore MCP Server — Connect AI assistants to WowStore.live European fashion store. Search 2,200+ products, get styling advice from Lucy AI, browse collections, create carts.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "fashion",
+    "shopping",
+    "e-commerce",
+    "wowstore",
+    "lucy",
+    "ai-stylist",
+    "european-fashion",
+    "claude",
+    "chatgpt",
+    "ai-agent"
+  ],
+  "main": "index.js",
+  "bin": {
+    "wowstore-mcp": "./index.js"
+  },
+  "scripts": {
+    "start": "node index.js"
+  },
+  "author": "WowStore <info@wowstore.live>",
+  "license": "MIT",
+  "homepage": "https://wowstore.live",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wowstore-live/mcp-server"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}