@striderlabs/mcp-hm 0.1.0

package/src/index.ts

@@ -0,0 +1,565 @@
+#!/usr/bin/env node
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+  type Tool,
+} from "@modelcontextprotocol/sdk/types.js";
+
+import {
+  checkLoginStatus,
+  initiateLogin,
+  logout,
+  searchProducts,
+  getProductDetails,
+  getSizeGuide,
+  addToCart,
+  viewCart,
+  initiateCheckout,
+  findStores,
+  getMemberRewards,
+  trackOrder,
+  getWishlist,
+  addToWishlist,
+  browseSale,
+  closeBrowser,
+} from "./browser.js";
+
+const tools: Tool[] = [
+  // ── Auth ──────────────────────────────────────────────────────────────
+  {
+    name: "hm_status",
+    description:
+      "Check H&M login status and session information. Call this first to see if the user is already logged in.",
+    inputSchema: { type: "object", properties: {} },
+  },
+  {
+    name: "hm_login",
+    description:
+      "Initiate H&M login flow. Opens the H&M login page in a browser so the user can sign in. After logging in, call hm_status to confirm.",
+    inputSchema: { type: "object", properties: {} },
+  },
+  {
+    name: "hm_logout",
+    description: "Log out of H&M and clear saved session data.",
+    inputSchema: { type: "object", properties: {} },
+  },
+
+  // ── Search ────────────────────────────────────────────────────────────
+  {
+    name: "hm_search_products",
+    description:
+      "Search H&M for clothing, accessories, and home items. Returns a list of matching products with prices and links.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: {
+          type: "string",
+          description: "Search term, e.g. 'black slim jeans', 'linen shirt', 'throw pillow'",
+        },
+        maxResults: {
+          type: "number",
+          description: "Maximum number of results to return (default: 10)",
+        },
+        category: {
+          type: "string",
+          description: "Filter by category, e.g. 'ladies', 'men', 'kids', 'home'",
+        },
+        sortBy: {
+          type: "string",
+          description: "Sort order: 'stock' | 'ascPrice' | 'descPrice' | 'newProduct'",
+          enum: ["stock", "ascPrice", "descPrice", "newProduct"],
+        },
+        onSaleOnly: {
+          type: "boolean",
+          description: "Only return sale/discounted items",
+        },
+      },
+      required: ["query"],
+    },
+  },
+
+  // ── Product details ───────────────────────────────────────────────────
+  {
+    name: "hm_product_details",
+    description:
+      "Get full details for a specific H&M product: description, available sizes, colors, materials, care instructions, and fit info.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        productUrl: {
+          type: "string",
+          description: "Product URL (from hm_search_products results) or H&M product path",
+        },
+      },
+      required: ["productUrl"],
+    },
+  },
+
+  // ── Size guide ────────────────────────────────────────────────────────
+  {
+    name: "hm_size_guide",
+    description:
+      "Get H&M size guide and fit recommendations for a given category (e.g. 'ladies tops', 'men trousers', 'kids 4-14Y').",
+    inputSchema: {
+      type: "object",
+      properties: {
+        category: {
+          type: "string",
+          description: "Category for the size guide, e.g. 'ladies', 'men', 'kids', 'babies'",
+        },
+      },
+      required: ["category"],
+    },
+  },
+
+  // ── Cart ──────────────────────────────────────────────────────────────
+  {
+    name: "hm_add_to_cart",
+    description:
+      "Add an H&M product to the shopping bag. Specify size and color if known.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        productUrl: {
+          type: "string",
+          description: "Product URL to add to bag",
+        },
+        size: {
+          type: "string",
+          description: "Size to select, e.g. 'S', 'M', 'L', '32', '10'",
+        },
+        color: {
+          type: "string",
+          description: "Color name or variant to select",
+        },
+        quantity: {
+          type: "number",
+          description: "Quantity to add (default: 1)",
+        },
+      },
+      required: ["productUrl"],
+    },
+  },
+  {
+    name: "hm_view_cart",
+    description: "View the current H&M shopping bag contents, including items, prices, and totals.",
+    inputSchema: { type: "object", properties: {} },
+  },
+  {
+    name: "hm_checkout",
+    description:
+      "Initiate the H&M checkout process. This navigates to checkout so the user can complete their order.",
+    inputSchema: { type: "object", properties: {} },
+  },
+
+  // ── Stores ────────────────────────────────────────────────────────────
+  {
+    name: "hm_find_stores",
+    description:
+      "Find H&M stores near a location. Optionally check in-store availability for a product.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        location: {
+          type: "string",
+          description: "City, zip code, or address to search near",
+        },
+        productId: {
+          type: "string",
+          description: "Optional product ID to check in-store stock",
+        },
+        radius: {
+          type: "number",
+          description: "Search radius in miles (default: 25)",
+        },
+      },
+      required: ["location"],
+    },
+  },
+
+  // ── Member rewards ────────────────────────────────────────────────────
+  {
+    name: "hm_member_rewards",
+    description:
+      "View H&M Member rewards, points balance, tier status, and available vouchers. Requires login.",
+    inputSchema: { type: "object", properties: {} },
+  },
+
+  // ── Order tracking ────────────────────────────────────────────────────
+  {
+    name: "hm_track_order",
+    description:
+      "Track H&M orders. Returns order history with status and estimated delivery. Optionally filter by order ID.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        orderId: {
+          type: "string",
+          description: "Optional order ID to filter results",
+        },
+      },
+    },
+  },
+
+  // ── Wishlist ──────────────────────────────────────────────────────────
+  {
+    name: "hm_view_wishlist",
+    description: "View saved H&M wishlist items with availability and prices.",
+    inputSchema: { type: "object", properties: {} },
+  },
+  {
+    name: "hm_add_to_wishlist",
+    description: "Save an H&M product to the wishlist/favorites.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        productUrl: {
+          type: "string",
+          description: "Product URL to save to wishlist",
+        },
+      },
+      required: ["productUrl"],
+    },
+  },
+
+  // ── Sale ──────────────────────────────────────────────────────────────
+  {
+    name: "hm_browse_sale",
+    description:
+      "Browse H&M sale and clearance items. Filter by category and sort by discount or price.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        category: {
+          type: "string",
+          description: "Category to browse: 'ladies', 'men', 'kids', 'home', 'baby'",
+        },
+        maxResults: {
+          type: "number",
+          description: "Maximum number of results (default: 20)",
+        },
+        sortBy: {
+          type: "string",
+          description: "Sort: 'ascPrice' | 'descPrice' | 'newProduct'",
+          enum: ["ascPrice", "descPrice", "newProduct"],
+        },
+      },
+    },
+  },
+];
+
+const server = new Server(
+  {
+    name: "striderlabs-mcp-hm",
+    version: "0.1.0",
+  },
+  {
+    capabilities: { tools: {} },
+  }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools }));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args = {} } = request.params;
+
+  try {
+    switch (name) {
+      // ── Auth ────────────────────────────────────────────────────────
+      case "hm_status": {
+        const status = await checkLoginStatus();
+        return {
+          content: [
+            {
+              type: "text",
+              text: status.isLoggedIn
+                ? `Logged in${status.userName ? ` as ${status.userName}` : ""}${status.userEmail ? ` (${status.userEmail})` : ""}`
+                : "Not logged in. Use hm_login to sign in.",
+            },
+          ],
+        };
+      }
+
+      case "hm_login": {
+        const result = await initiateLogin();
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Login page opened: ${result.url}\n\n${result.instructions}`,
+            },
+          ],
+        };
+      }
+
+      case "hm_logout": {
+        await logout();
+        return {
+          content: [{ type: "text", text: "Logged out successfully. Session data cleared." }],
+        };
+      }
+
+      // ── Search ──────────────────────────────────────────────────────
+      case "hm_search_products": {
+        const { query, maxResults, category, sortBy, onSaleOnly } = args as {
+          query: string;
+          maxResults?: number;
+          category?: string;
+          sortBy?: string;
+          onSaleOnly?: boolean;
+        };
+        const results = await searchProducts(query, { maxResults, category, sortBy, onSaleOnly });
+        if (results.length === 0) {
+          return {
+            content: [{ type: "text", text: `No products found for "${query}". Try a different search term.` }],
+          };
+        }
+        const text = results
+          .map(
+            (r, i) =>
+              `${i + 1}. **${r.name}**\n   Price: ${r.price}${r.originalPrice ? ` (was ${r.originalPrice})` : ""}${r.isOnSale ? " 🔴 SALE" : ""}${r.color ? `\n   Color: ${r.color}` : ""}${r.productUrl ? `\n   URL: ${r.productUrl}` : ""}`
+          )
+          .join("\n\n");
+        return { content: [{ type: "text", text: `Found ${results.length} products for "${query}":\n\n${text}` }] };
+      }
+
+      // ── Product details ─────────────────────────────────────────────
+      case "hm_product_details": {
+        const { productUrl } = args as { productUrl: string };
+        const details = await getProductDetails(productUrl);
+        const lines = [
+          `**${details.name}**`,
+          `Price: ${details.price}${details.originalPrice ? ` (was ${details.originalPrice})` : ""}`,
+        ];
+        if (details.description) lines.push(`\nDescription: ${details.description}`);
+        if (details.fit) lines.push(`Fit: ${details.fit}`);
+        if (details.colors.length) lines.push(`Colors: ${details.colors.join(", ")}`);
+        if (details.sizes.length) lines.push(`All sizes: ${details.sizes.join(", ")}`);
+        if (details.availableSizes.length) lines.push(`Available sizes: ${details.availableSizes.join(", ")}`);
+        if (details.materials) lines.push(`\nMaterials: ${details.materials}`);
+        if (details.careInstructions) lines.push(`Care: ${details.careInstructions}`);
+        if (details.category) lines.push(`Category: ${details.category}`);
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+      }
+
+      // ── Size guide ──────────────────────────────────────────────────
+      case "hm_size_guide": {
+        const { category } = args as { category: string };
+        const guide = await getSizeGuide(category);
+        if (guide.length === 0) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `No size guide data found for "${category}". Visit https://www2.hm.com/en_us/customer-service/size-guide.html for the full guide.`,
+              },
+            ],
+          };
+        }
+        const text = guide
+          .map(
+            (g) =>
+              `**${g.garmentType}**\n${Object.entries(g.measurements)
+                .map(([k, v]) => `  ${k}: ${v}`)
+                .join("\n")}${g.tips ? `\nTips: ${g.tips}` : ""}`
+          )
+          .join("\n\n");
+        return { content: [{ type: "text", text: `H&M Size Guide - ${category}:\n\n${text}` }] };
+      }
+
+      // ── Cart ────────────────────────────────────────────────────────
+      case "hm_add_to_cart": {
+        const { productUrl, size, color, quantity } = args as {
+          productUrl: string;
+          size?: string;
+          color?: string;
+          quantity?: number;
+        };
+        const result = await addToCart(productUrl, { size, color, quantity });
+        return { content: [{ type: "text", text: result.message }] };
+      }
+
+      case "hm_view_cart": {
+        const cart = await viewCart();
+        if (cart.items.length === 0) {
+          return { content: [{ type: "text", text: "Your shopping bag is empty." }] };
+        }
+        const itemLines = cart.items.map(
+          (item, i) =>
+            `${i + 1}. ${item.name}${item.color ? ` - ${item.color}` : ""}${item.size ? ` / ${item.size}` : ""} × ${item.quantity} — ${item.price}`
+        );
+        const text = [
+          `Shopping Bag (${cart.itemCount} item${cart.itemCount !== 1 ? "s" : ""})`,
+          ...itemLines,
+          "",
+          cart.subtotal ? `Subtotal: ${cart.subtotal}` : "",
+          cart.estimatedShipping ? `Shipping: ${cart.estimatedShipping}` : "",
+          cart.total ? `Total: ${cart.total}` : "",
+        ]
+          .filter(Boolean)
+          .join("\n");
+        return { content: [{ type: "text", text }] };
+      }
+
+      case "hm_checkout": {
+        const result = await initiateCheckout();
+        return { content: [{ type: "text", text: result.message + "\nCheckout URL: " + result.url }] };
+      }
+
+      // ── Stores ──────────────────────────────────────────────────────
+      case "hm_find_stores": {
+        const { location, productId, radius } = args as {
+          location: string;
+          productId?: string;
+          radius?: number;
+        };
+        const stores = await findStores(location, { productId, radius });
+        if (stores.length === 0) {
+          return { content: [{ type: "text", text: `No H&M stores found near "${location}".` }] };
+        }
+        const text = stores
+          .map(
+            (s, i) =>
+              `${i + 1}. **${s.name}**\n   ${s.address}${s.city ? `, ${s.city}` : ""}${s.distance ? ` (${s.distance})` : ""}${s.phone ? `\n   Tel: ${s.phone}` : ""}${s.hours ? `\n   Hours: ${s.hours}` : ""}`
+          )
+          .join("\n\n");
+        return { content: [{ type: "text", text: `H&M stores near ${location}:\n\n${text}` }] };
+      }
+
+      // ── Member rewards ──────────────────────────────────────────────
+      case "hm_member_rewards": {
+        const member = await getMemberRewards();
+        const lines = ["**H&M Member Rewards**"];
+        if (member.name) lines.push(`Name: ${member.name}`);
+        if (member.email) lines.push(`Email: ${member.email}`);
+        if (member.tier) lines.push(`Status: ${member.tier}`);
+        if (member.points) lines.push(`Points: ${member.points}`);
+        if (member.nextReward) lines.push(`Next reward: ${member.nextReward}`);
+        if (member.rewards?.length) {
+          lines.push("\nAvailable rewards:");
+          member.rewards.forEach((r) => lines.push(`  • ${r}`));
+        }
+        if (lines.length === 1) {
+          lines.push("No rewards data found. Make sure you are logged in (use hm_login).");
+        }
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+      }
+
+      // ── Order tracking ──────────────────────────────────────────────
+      case "hm_track_order": {
+        const { orderId } = args as { orderId?: string };
+        const orders = await trackOrder(orderId);
+        if (orders.length === 0) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: orderId
+                  ? `No order found with ID "${orderId}".`
+                  : "No orders found. Make sure you are logged in.",
+              },
+            ],
+          };
+        }
+        const text = orders
+          .map(
+            (o, i) =>
+              `${i + 1}. Order ${o.orderId || "(no ID)"} — ${o.date}\n   Status: ${o.status}\n   Total: ${o.total}${o.estimatedDelivery ? `\n   Est. delivery: ${o.estimatedDelivery}` : ""}${o.trackingNumber ? `\n   Tracking: ${o.trackingNumber}` : ""}${o.items?.length ? `\n   Items: ${o.items.join(", ")}` : ""}`
+          )
+          .join("\n\n");
+        return { content: [{ type: "text", text: `Order history:\n\n${text}` }] };
+      }
+
+      // ── Wishlist ────────────────────────────────────────────────────
+      case "hm_view_wishlist": {
+        const items = await getWishlist();
+        if (items.length === 0) {
+          return { content: [{ type: "text", text: "Your wishlist is empty." }] };
+        }
+        const text = items
+          .map(
+            (item, i) =>
+              `${i + 1}. **${item.name}** — ${item.price}${item.color ? ` (${item.color})` : ""} ${item.inStock ? "✓ In stock" : "✗ Out of stock"}${item.productUrl ? `\n   ${item.productUrl}` : ""}`
+          )
+          .join("\n\n");
+        return { content: [{ type: "text", text: `Wishlist (${items.length} item${items.length !== 1 ? "s" : ""}):\n\n${text}` }] };
+      }
+
+      case "hm_add_to_wishlist": {
+        const { productUrl } = args as { productUrl: string };
+        const result = await addToWishlist(productUrl);
+        return { content: [{ type: "text", text: result.message }] };
+      }
+
+      // ── Sale ────────────────────────────────────────────────────────
+      case "hm_browse_sale": {
+        const { category, maxResults, sortBy } = args as {
+          category?: string;
+          maxResults?: number;
+          sortBy?: string;
+        };
+        const results = await browseSale({ category, maxResults, sortBy });
+        if (results.length === 0) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `No sale items found${category ? ` in "${category}"` : ""}. Visit https://www2.hm.com/en_us/sale for current promotions.`,
+              },
+            ],
+          };
+        }
+        const text = results
+          .map(
+            (r, i) =>
+              `${i + 1}. **${r.name}**\n   Price: ${r.price}${r.originalPrice ? ` (was ${r.originalPrice})` : ""}${r.discount ? ` — ${r.discount} off` : ""}${r.productUrl ? `\n   ${r.productUrl}` : ""}`
+          )
+          .join("\n\n");
+        return {
+          content: [
+            { type: "text", text: `H&M Sale${category ? ` — ${category}` : ""} (${results.length} items):\n\n${text}` },
+          ],
+        };
+      }
+
+      default:
+        return {
+          content: [{ type: "text", text: `Unknown tool: ${name}` }],
+          isError: true,
+        };
+    }
+  } catch (error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Error running ${name}: ${msg}\n\nTip: Make sure Chrome is installed and try again. If login-related, use hm_login first.`,
+        },
+      ],
+      isError: true,
+    };
+  }
+});
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch((err) => {
+  console.error("H&M MCP server failed to start:", err);
+  process.exit(1);
+});
+
+process.on("SIGINT", async () => {
+  await closeBrowser();
+  process.exit(0);
+});
+process.on("SIGTERM", async () => {
+  await closeBrowser();
+  process.exit(0);
+});

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true
+  },
+  "include": ["src/**/*"]
+}