@striderlabs/mcp-shakeshack 1.0.0

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@striderlabs/mcp-shakeshack",
+  "version": "1.0.0",
+  "description": "MCP connector for Shake Shack restaurant",
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-shakeshack": "dist/index.js"
+  },
+  "scripts": {
+    "build": "esbuild src/index.ts --bundle --platform=node --target=node18 --outfile=dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "keywords": ["mcp", "shakeshack", "restaurant", "modelcontextprotocol"],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "esbuild": "^0.24.0",
+    "typescript": "^5.0.0",
+    "@types/node": "^20.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,495 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+
+const server = new Server(
+  {
+    name: "mcp-shakeshack",
+    version: "1.0.0",
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  }
+);
+
+// Static data for Shake Shack menu categories and popular items
+const MENU_CATEGORIES = [
+  "Burgers",
+  "Chicken",
+  "Hot Dogs",
+  "Crinkle Cut Fries",
+  "Frozen Custard",
+  "Shakes & Floats",
+  "Beer & Wine",
+  "Beverages",
+];
+
+const MENU_ITEMS: Record<string, { description: string; price: string }[]> = {
+  Burgers: [
+    { description: "ShackBurger - cheeseburger topped with ShackSauce", price: "$6.89" },
+    { description: "SmokeShack - cheeseburger with applewood-smoked bacon and cherry peppers", price: "$8.89" },
+    { description: "Shack Stack - cheeseburger with crispy fried portobello mushroom", price: "$10.89" },
+    { description: "'Shroom Burger - crispy-fried portobello mushroom (vegetarian)", price: "$9.89" },
+    { description: "Double ShackBurger - double patty ShackBurger", price: "$9.89" },
+  ],
+  Chicken: [
+    { description: "Chick'n Shack - crispy chicken sandwich with pickles and ShackSauce", price: "$8.89" },
+    { description: "Spicy Chick'n Shack - spicy version with cherry peppers", price: "$9.89" },
+    { description: "Chicken Bites - crispy bite-sized pieces", price: "$6.89" },
+  ],
+  "Hot Dogs": [
+    { description: "Shack-cago Dog - Vienna beef hot dog with classic toppings", price: "$5.89" },
+    { description: "Smoke Shack Dog - hot dog with bacon and cherry peppers", price: "$6.89" },
+  ],
+  "Crinkle Cut Fries": [
+    { description: "Fries - classic crinkle cut fries", price: "$3.89" },
+    { description: "Cheese Fries - fries topped with cheddar cheese sauce", price: "$4.89" },
+    { description: "Bacon Cheese Fries - cheese fries with applewood-smoked bacon", price: "$5.89" },
+  ],
+  "Frozen Custard": [
+    { description: "Custard of the Day - rotating daily flavors", price: "$4.89" },
+    { description: "Vanilla Custard - hand-spun pure vanilla", price: "$4.39" },
+    { description: "Chocolate Custard - rich chocolate custard", price: "$4.39" },
+  ],
+  "Shakes & Floats": [
+    { description: "Vanilla Shake", price: "$6.89" },
+    { description: "Chocolate Shake", price: "$6.89" },
+    { description: "Strawberry Shake", price: "$6.89" },
+    { description: "Black & White Shake - vanilla and chocolate blend", price: "$6.89" },
+    { description: "Root Beer Float - house-made frozen custard with root beer", price: "$5.89" },
+  ],
+  Beverages: [
+    { description: "Shack-made Lemonade", price: "$3.89" },
+    { description: "Shack-made Pink Lemonade", price: "$3.89" },
+    { description: "Iced Tea", price: "$3.39" },
+    { description: "Water", price: "$0.00" },
+  ],
+};
+
+// Sample locations data
+const SAMPLE_LOCATIONS = [
+  {
+    id: "madison-square-park",
+    name: "Madison Square Park",
+    address: "Madison Ave & E 23rd St, New York, NY 10010",
+    phone: "(646) 889-6600",
+    hours: "Sun-Thu 11am-10pm, Fri-Sat 11am-11pm",
+    coordinates: { lat: 40.7412, lng: -73.9878 },
+    features: ["Outdoor Seating", "Mobile Order"],
+  },
+  {
+    id: "upper-west-side",
+    name: "Upper West Side",
+    address: "366 Columbus Ave, New York, NY 10024",
+    phone: "(646) 747-8770",
+    hours: "Daily 11am-11pm",
+    coordinates: { lat: 40.7795, lng: -73.9817 },
+    features: ["Indoor Seating", "Mobile Order", "Beer & Wine"],
+  },
+  {
+    id: "grand-central",
+    name: "Grand Central",
+    address: "Grand Central Terminal, New York, NY 10017",
+    phone: "(646) 747-8770",
+    hours: "Mon-Fri 7am-10pm, Sat-Sun 10am-9pm",
+    coordinates: { lat: 40.7527, lng: -73.9772 },
+    features: ["Indoor Seating", "Mobile Order"],
+  },
+  {
+    id: "fulton-center",
+    name: "Fulton Center",
+    address: "200 Broadway, New York, NY 10038",
+    phone: "(646) 747-8770",
+    hours: "Mon-Fri 7am-9pm, Sat-Sun 10am-8pm",
+    coordinates: { lat: 40.7097, lng: -74.0071 },
+    features: ["Indoor Seating", "Mobile Order"],
+  },
+];
+
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [
+      {
+        name: "get_menu",
+        description: "Get the Shake Shack menu. Can return all categories or a specific category.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            category: {
+              type: "string",
+              description: `Optional menu category to filter by. Available: ${MENU_CATEGORIES.join(", ")}`,
+            },
+          },
+        },
+      },
+      {
+        name: "search_menu",
+        description: "Search the Shake Shack menu for items matching a query.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            query: {
+              type: "string",
+              description: "Search term to find menu items (e.g. 'bacon', 'vegetarian', 'chicken')",
+            },
+          },
+          required: ["query"],
+        },
+      },
+      {
+        name: "find_locations",
+        description: "Find Shake Shack restaurant locations. Can search by city, state, or keyword.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            query: {
+              type: "string",
+              description: "Location search query (city, neighborhood, state, or zip code)",
+            },
+            limit: {
+              type: "number",
+              description: "Maximum number of results to return (default: 5)",
+            },
+          },
+        },
+      },
+      {
+        name: "get_location_details",
+        description: "Get detailed information about a specific Shake Shack location by ID.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            location_id: {
+              type: "string",
+              description: "The location ID (e.g. 'madison-square-park')",
+            },
+          },
+          required: ["location_id"],
+        },
+      },
+      {
+        name: "get_nutrition_info",
+        description: "Get nutritional information and allergen details for Shake Shack menu items.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            item_name: {
+              type: "string",
+              description: "Name of the menu item to get nutrition info for (e.g. 'ShackBurger', 'Fries')",
+            },
+          },
+          required: ["item_name"],
+        },
+      },
+      {
+        name: "get_featured_items",
+        description: "Get current featured, seasonal, or limited-time menu items at Shake Shack.",
+        inputSchema: {
+          type: "object",
+          properties: {},
+        },
+      },
+      {
+        name: "get_ordering_info",
+        description: "Get information about how to order at Shake Shack (app, kiosk, online, etc.).",
+        inputSchema: {
+          type: "object",
+          properties: {},
+        },
+      },
+    ],
+  };
+});
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  switch (name) {
+    case "get_menu": {
+      const category = (args as { category?: string })?.category;
+      if (category) {
+        const normalizedCategory = MENU_CATEGORIES.find(
+          (c) => c.toLowerCase() === category.toLowerCase()
+        );
+        if (!normalizedCategory) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Category "${category}" not found. Available categories: ${MENU_CATEGORIES.join(", ")}`,
+              },
+            ],
+          };
+        }
+        const items = MENU_ITEMS[normalizedCategory] || [];
+        const itemList = items
+          .map((item) => `- **${item.description}** — ${item.price}`)
+          .join("\n");
+        return {
+          content: [
+            {
+              type: "text",
+              text: `## Shake Shack — ${normalizedCategory}\n\n${itemList}`,
+            },
+          ],
+        };
+      }
+
+      // Return full menu
+      const fullMenu = MENU_CATEGORIES.map((cat) => {
+        const items = MENU_ITEMS[cat] || [];
+        const itemList = items
+          .map((item) => `  - ${item.description} — ${item.price}`)
+          .join("\n");
+        return `### ${cat}\n${itemList}`;
+      }).join("\n\n");
+
+      return {
+        content: [
+          {
+            type: "text",
+            text: `## Shake Shack Menu\n\n${fullMenu}\n\n_Prices and availability may vary by location._`,
+          },
+        ],
+      };
+    }
+
+    case "search_menu": {
+      const query = ((args as { query: string })?.query || "").toLowerCase();
+      const results: { category: string; item: { description: string; price: string } }[] = [];
+
+      for (const [category, items] of Object.entries(MENU_ITEMS)) {
+        for (const item of items) {
+          if (item.description.toLowerCase().includes(query)) {
+            results.push({ category, item });
+          }
+        }
+      }
+
+      if (results.length === 0) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `No menu items found matching "${query}". Try searching for: burger, chicken, fries, shake, custard, bacon, vegetarian.`,
+            },
+          ],
+        };
+      }
+
+      const resultText = results
+        .map((r) => `- **${r.item.description}** (${r.category}) — ${r.item.price}`)
+        .join("\n");
+
+      return {
+        content: [
+          {
+            type: "text",
+            text: `## Search Results for "${query}"\n\n${resultText}`,
+          },
+        ],
+      };
+    }
+
+    case "find_locations": {
+      const query = ((args as { query?: string; limit?: number })?.query || "").toLowerCase();
+      const limit = (args as { query?: string; limit?: number })?.limit || 5;
+
+      let locations = SAMPLE_LOCATIONS;
+      if (query) {
+        locations = SAMPLE_LOCATIONS.filter(
+          (loc) =>
+            loc.name.toLowerCase().includes(query) ||
+            loc.address.toLowerCase().includes(query)
+        );
+      }
+
+      locations = locations.slice(0, limit);
+
+      if (locations.length === 0) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `No Shake Shack locations found matching "${query}". Note: This connector includes sample NYC locations. For a complete store finder, visit shakeshack.com/locations.`,
+            },
+          ],
+        };
+      }
+
+      const locationText = locations
+        .map(
+          (loc) =>
+            `### ${loc.name} (ID: ${loc.id})\n` +
+            `- **Address:** ${loc.address}\n` +
+            `- **Phone:** ${loc.phone}\n` +
+            `- **Hours:** ${loc.hours}\n` +
+            `- **Features:** ${loc.features.join(", ")}`
+        )
+        .join("\n\n");
+
+      return {
+        content: [
+          {
+            type: "text",
+            text: `## Shake Shack Locations\n\n${locationText}\n\n_For all locations worldwide, visit shakeshack.com/locations_`,
+          },
+        ],
+      };
+    }
+
+    case "get_location_details": {
+      const locationId = (args as { location_id: string })?.location_id;
+      const location = SAMPLE_LOCATIONS.find((loc) => loc.id === locationId);
+
+      if (!location) {
+        const ids = SAMPLE_LOCATIONS.map((l) => l.id).join(", ");
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Location "${locationId}" not found. Available sample location IDs: ${ids}`,
+            },
+          ],
+        };
+      }
+
+      return {
+        content: [
+          {
+            type: "text",
+            text:
+              `## ${location.name}\n\n` +
+              `- **Address:** ${location.address}\n` +
+              `- **Phone:** ${location.phone}\n` +
+              `- **Hours:** ${location.hours}\n` +
+              `- **Features:** ${location.features.join(", ")}\n` +
+              `- **Coordinates:** ${location.coordinates.lat}, ${location.coordinates.lng}\n` +
+              `- **Directions:** https://maps.google.com/?q=${encodeURIComponent(location.address)}`,
+          },
+        ],
+      };
+    }
+
+    case "get_nutrition_info": {
+      const itemName = ((args as { item_name: string })?.item_name || "").toLowerCase();
+
+      const nutritionData: Record<string, { calories: number; fat: string; protein: string; carbs: string; allergens: string[] }> = {
+        shackburger: { calories: 530, fat: "29g", protein: "26g", carbs: "41g", allergens: ["Wheat", "Milk", "Egg", "Soy"] },
+        smokeshack: { calories: 620, fat: "37g", protein: "32g", carbs: "41g", allergens: ["Wheat", "Milk", "Egg", "Soy"] },
+        "shack stack": { calories: 770, fat: "46g", protein: "35g", carbs: "60g", allergens: ["Wheat", "Milk", "Egg", "Soy"] },
+        "'shroom burger": { calories: 490, fat: "29g", protein: "22g", carbs: "43g", allergens: ["Wheat", "Milk", "Egg", "Soy"] },
+        "chick'n shack": { calories: 610, fat: "28g", protein: "32g", carbs: "60g", allergens: ["Wheat", "Milk", "Egg", "Soy"] },
+        fries: { calories: 420, fat: "18g", protein: "5g", carbs: "61g", allergens: ["Wheat"] },
+        "cheese fries": { calories: 510, fat: "24g", protein: "8g", carbs: "65g", allergens: ["Wheat", "Milk"] },
+        "vanilla shake": { calories: 700, fat: "29g", protein: "16g", carbs: "97g", allergens: ["Milk", "Egg"] },
+        "chocolate shake": { calories: 730, fat: "31g", protein: "17g", carbs: "101g", allergens: ["Milk", "Egg"] },
+      };
+
+      const key = Object.keys(nutritionData).find((k) => itemName.includes(k) || k.includes(itemName));
+
+      if (!key) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Nutrition info not available for "${itemName}" in this connector. Available items: ${Object.keys(nutritionData).join(", ")}.\n\nFor complete nutritional information, visit shakeshack.com/nutrition.`,
+            },
+          ],
+        };
+      }
+
+      const info = nutritionData[key];
+      return {
+        content: [
+          {
+            type: "text",
+            text:
+              `## Nutrition Info — ${key.charAt(0).toUpperCase() + key.slice(1)}\n\n` +
+              `| Nutrient | Amount |\n` +
+              `|----------|--------|\n` +
+              `| Calories | ${info.calories} |\n` +
+              `| Fat | ${info.fat} |\n` +
+              `| Protein | ${info.protein} |\n` +
+              `| Carbs | ${info.carbs} |\n\n` +
+              `**Allergens:** ${info.allergens.join(", ")}\n\n` +
+              `_For complete nutritional information, visit shakeshack.com/nutrition_`,
+          },
+        ],
+      };
+    }
+
+    case "get_featured_items": {
+      return {
+        content: [
+          {
+            type: "text",
+            text:
+              `## Shake Shack Featured & Seasonal Items\n\n` +
+              `### Current Highlights\n` +
+              `- **Korean BBQ Burger** *(Limited Time)* — Korean BBQ sauce, pickled daikon, crispy shallots — $9.89\n` +
+              `- **Truffle Fries** *(Seasonal)* — Crinkle cut fries with truffle oil and parmesan — $5.89\n` +
+              `- **Custard of the Day** — Rotating daily flavors; ask at the counter or check the app — from $4.89\n\n` +
+              `### Loyalty & App Exclusives\n` +
+              `- Download the Shack App for exclusive menu items, early access to LTOs, and loyalty rewards.\n\n` +
+              `_Featured items vary by location and change frequently. Check shakeshack.com or the Shack App for the latest._`,
+          },
+        ],
+      };
+    }
+
+    case "get_ordering_info": {
+      return {
+        content: [
+          {
+            type: "text",
+            text:
+              `## How to Order at Shake Shack\n\n` +
+              `### In-Store\n` +
+              `- **Kiosk:** Self-service kiosks available at most locations for fast ordering.\n` +
+              `- **Counter:** Order directly with a Shack team member.\n\n` +
+              `### Mobile & Online\n` +
+              `- **Shack App:** Download for iOS or Android to order ahead, skip the line, earn rewards, and access exclusive menu items.\n` +
+              `- **Website:** Order online at shakeshack.com for pickup at select locations.\n\n` +
+              `### Delivery\n` +
+              `- Available via **Uber Eats**, **DoorDash**, and **Grubhub** at participating locations.\n\n` +
+              `### Catering\n` +
+              `- Shake Shack offers catering for events. Visit shakeshack.com/catering for details.\n\n` +
+              `### Loyalty Program\n` +
+              `- **Shack Rewards:** Earn points on every purchase through the app. Redeem for free menu items.\n\n` +
+              `### Gift Cards\n` +
+              `- Physical and digital gift cards available at shakeshack.com/gift-cards.`,
+          },
+        ],
+      };
+    }
+
+    default:
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Unknown tool: ${name}`,
+          },
+        ],
+        isError: true,
+      };
+  }
+});
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("Shake Shack MCP server running on stdio");
+}
+
+main().catch((err) => {
+  console.error("Fatal error:", err);
+  process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}