migros-mcp 0.1.0

package/README.md

@@ -0,0 +1,115 @@
+# migros-mcp
+
+Search [Migros](https://www.migros.ch) products, get nutrition facts, find stores, and browse promotions with Claude.
+
+> **Important**
+> This is **not affiliated with Migros** in any way.
+> It uses publicly accessible API endpoints -- there is no official Migros API.
+> It can **break at any time** if Migros changes their endpoints.
+> No authentication required -- uses guest access only.
+> **Use at your own risk.**
+
+## What you can do
+
+Once installed, just talk to Claude naturally:
+
+- "Search Migros for protein bars"
+- "What's the nutrition info for this Migros product?"
+- "Find Migros stores near Steinhausen"
+- "What promotions does Migros have right now?"
+- "Compare the protein content of these two products"
+- "Which Migros products are gluten-free?"
+
+## Install
+
+No accounts or credentials needed. This server uses Migros guest access.
+
+### Claude Desktop (recommended)
+
+1. Download [migros-mcp.mcpb](https://github.com/lewpgs/migros-mcp/releases/latest/download/migros-mcp.mcpb)
+2. Install it:
+
+   **macOS** - Double-click the file, or drag and drop it onto the Claude Desktop app icon
+
+   **Windows** - In Claude Desktop, go to File > Settings > Extensions > Advanced Settings > Install Extension and select the file
+
+That's it. No credentials needed.
+
+---
+
+## Advanced setup
+
+These methods require [Node.js 18+](https://nodejs.org) installed on your machine.
+
+### Claude Code
+
+```bash
+claude mcp add migros -- npx -y migros-mcp
+```
+
+### Claude Desktop (manual) / Cursor
+
+Add the following to your config file:
+
+- **Claude Desktop** - `claude_desktop_config.json`
+- **Cursor** - `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global)
+
+```json
+{
+  "mcpServers": {
+    "migros": {
+      "command": "npx",
+      "args": ["-y", "migros-mcp"]
+    }
+  }
+}
+```
+
+### Test connection
+
+```bash
+npx migros-mcp
+```
+
+## Available tools
+
+| Tool | Description |
+|---|---|
+| `search_products` | Search Migros products by name or keyword. Returns product IDs. |
+| `get_product_details` | Get full product info: nutrition, ingredients, allergens, price, ratings. |
+| `get_categories` | List all Migros product categories. |
+| `search_stores` | Find Migros stores by location with addresses and opening hours. |
+| `get_promotions` | Search current Migros promotions and deals. |
+
+## How it works
+
+Migros does not offer a public API. This MCP server uses the [migros-api-wrapper](https://www.npmjs.com/package/migros-api-wrapper) package, which wraps the same endpoints that the Migros website and app use internally. A guest token is obtained at startup (no login required) and cached for the session.
+
+Product searches return IDs that you then pass to `get_product_details` for full nutrition tables, ingredients, allergens, and pricing.
+
+## Development
+
+```bash
+git clone https://github.com/lewpgs/migros-mcp.git
+cd migros-mcp
+npm install
+npm run build
+node dist/index.js
+```
+
+Debug with the MCP Inspector:
+
+```bash
+npx -y @modelcontextprotocol/inspector npx migros-mcp
+```
+
+## Disclaimers
+
+- **Unofficial** - This project is not affiliated with, endorsed by, or connected to Migros in any way.
+- **No official API** - This server uses publicly accessible API endpoints that power the Migros website. These are not documented or officially supported. Changes to Migros infrastructure could break this server without notice.
+- **No authentication required** - Uses guest access only. No credentials are stored or transmitted.
+- **Use at your own risk** - No guarantees of functionality, availability, or compatibility.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { SearchProductsSchema, GetProductDetailsSchema, SearchStoresSchema, GetPromotionsSchema, } from "./schemas.js";
+import { searchProducts, getProductDetails, getCategories, searchStores, getPromotions, } from "./tools.js";
+const server = new McpServer({
+    name: "migros-mcp",
+    version: "0.1.0",
+});
+// --- Tools ---
+server.tool("search_products", "Search Migros products by name or keyword. Returns product IDs that can be used with get_product_details.", SearchProductsSchema.shape, async ({ query, language }) => {
+    try {
+        const result = await searchProducts(query, language ?? "de");
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (error) {
+        return {
+            content: [{ type: "text", text: `Error: ${error.message}` }],
+            isError: true,
+        };
+    }
+});
+server.tool("get_product_details", "Get full product details including nutrition facts, ingredients, allergens, price, and ratings. Use search_products first to get product IDs.", GetProductDetailsSchema.shape, async ({ productIds }) => {
+    try {
+        const result = await getProductDetails(productIds);
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (error) {
+        return {
+            content: [{ type: "text", text: `Error: ${error.message}` }],
+            isError: true,
+        };
+    }
+});
+server.tool("get_categories", "List all Migros product categories", {}, async () => {
+    try {
+        const result = await getCategories();
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (error) {
+        return {
+            content: [{ type: "text", text: `Error: ${error.message}` }],
+            isError: true,
+        };
+    }
+});
+server.tool("search_stores", "Find Migros stores by location (city name, zip code, etc.). Returns store details including address and opening hours.", SearchStoresSchema.shape, async ({ query }) => {
+    try {
+        const result = await searchStores(query);
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (error) {
+        return {
+            content: [{ type: "text", text: `Error: ${error.message}` }],
+            isError: true,
+        };
+    }
+});
+server.tool("get_promotions", "Search current Migros promotions and deals. Optionally filter by search query.", GetPromotionsSchema.shape, async ({ query }) => {
+    try {
+        const result = await getPromotions(query ?? "");
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (error) {
+        return {
+            content: [{ type: "text", text: `Error: ${error.message}` }],
+            isError: true,
+        };
+    }
+});
+// --- Start ---
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/migros.d.ts

@@ -0,0 +1,8 @@
+export declare function searchProducts(query: string, language: string): Promise<{
+    productIds: string[];
+    numberOfProducts: number;
+}>;
+export declare function getProductDetails(productIds: string[]): Promise<unknown[]>;
+export declare function getCategories(): Promise<unknown>;
+export declare function searchStores(query: string): Promise<unknown[]>;
+export declare function getPromotions(query: string): Promise<unknown>;

package/dist/migros.js

@@ -0,0 +1,67 @@
+import { MigrosAPI } from "migros-api-wrapper";
+const migros = new MigrosAPI();
+let cachedToken = null;
+async function getToken() {
+    if (cachedToken) {
+        return cachedToken;
+    }
+    const result = await migros.account.oauth2.loginGuestToken();
+    cachedToken = result.token;
+    return cachedToken;
+}
+/**
+ * Reset the cached token so the next call fetches a fresh one.
+ * Useful if a request fails due to token expiry.
+ */
+function clearToken() {
+    cachedToken = null;
+}
+/**
+ * Wrapper that retries once with a fresh token on failure.
+ */
+async function withToken(fn) {
+    try {
+        const token = await getToken();
+        return await fn(token);
+    }
+    catch (error) {
+        // Token might have expired, try once more with a fresh one
+        clearToken();
+        const token = await getToken();
+        return await fn(token);
+    }
+}
+export async function searchProducts(query, language) {
+    return withToken(async (token) => {
+        const result = await migros.products.productSearch.searchProduct({ query, language: language }, {}, token);
+        return {
+            productIds: result.productIds ?? [],
+            numberOfProducts: result.numberOfProducts ?? 0,
+        };
+    });
+}
+export async function getProductDetails(productIds) {
+    return withToken(async (token) => {
+        const result = await migros.products.productDisplay.getProductDetails({ uids: productIds }, token);
+        return result ?? [];
+    });
+}
+export async function getCategories() {
+    return withToken(async (token) => {
+        const result = await migros.products.productSearch.categoryList({}, token);
+        return result?.categories ?? [];
+    });
+}
+export async function searchStores(query) {
+    return withToken(async (token) => {
+        const result = await migros.stores.searchStores({ query }, token);
+        return result ?? [];
+    });
+}
+export async function getPromotions(query) {
+    return withToken(async (token) => {
+        const result = await migros.products.productDisplay.getProductPromotionSearch({ query }, token);
+        return result?.items ?? [];
+    });
+}
+//# sourceMappingURL=migros.js.map

package/dist/migros.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migros.js","sourceRoot":"","sources":["../src/migros.ts"],"names":[],"mappings":"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"}

package/dist/schemas.d.ts

@@ -0,0 +1,32 @@
+import { z } from "zod";
+export declare const SearchProductsSchema: z.ZodObject<{
+    query: z.ZodString;
+    language: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    language: string;
+}, {
+    query: string;
+    language?: string | undefined;
+}>;
+export declare const GetProductDetailsSchema: z.ZodObject<{
+    productIds: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    productIds: string[];
+}, {
+    productIds: string[];
+}>;
+export declare const SearchStoresSchema: z.ZodObject<{
+    query: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+}, {
+    query: string;
+}>;
+export declare const GetPromotionsSchema: z.ZodObject<{
+    query: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+}, {
+    query?: string | undefined;
+}>;

package/dist/schemas.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+export const SearchProductsSchema = z.object({
+    query: z.string().describe("Search query for Migros products"),
+    language: z
+        .string()
+        .optional()
+        .default("de")
+        .describe("Language for results (de, fr, it, en). Default: de"),
+});
+export const GetProductDetailsSchema = z.object({
+    productIds: z
+        .array(z.string())
+        .describe("Array of product IDs (UIDs) to get details for. Get these from search_products first."),
+});
+export const SearchStoresSchema = z.object({
+    query: z
+        .string()
+        .describe("Search query for Migros stores (city name, zip code, etc.)"),
+});
+export const GetPromotionsSchema = z.object({
+    query: z
+        .string()
+        .optional()
+        .default("")
+        .describe("Optional search query to filter promotions"),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC9D,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,oDAAoD,CAAC;CAClE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,UAAU,EAAE,CAAC;SACV,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,CACP,uFAAuF,CACxF;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,CAAC,4DAA4D,CAAC;CAC1E,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,4CAA4C,CAAC;CAC1D,CAAC,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,5 @@
+export declare function searchProducts(query: string, language: string): Promise<string>;
+export declare function getProductDetails(productIds: string[]): Promise<string>;
+export declare function getCategories(): Promise<string>;
+export declare function searchStores(query: string): Promise<string>;
+export declare function getPromotions(query: string): Promise<string>;

package/dist/tools.js

@@ -0,0 +1,120 @@
+import { searchProducts as apiSearchProducts, getProductDetails as apiGetProductDetails, getCategories as apiGetCategories, searchStores as apiSearchStores, getPromotions as apiGetPromotions, } from "./migros.js";
+export async function searchProducts(query, language) {
+    const result = await apiSearchProducts(query, language);
+    if (result.productIds.length === 0) {
+        return JSON.stringify({
+            message: `No products found for "${query}"`,
+            numberOfProducts: 0,
+            productIds: [],
+        });
+    }
+    return JSON.stringify({
+        numberOfProducts: result.numberOfProducts,
+        productIds: result.productIds,
+        hint: "Use get_product_details with these product IDs to get full product info including nutrition, price, and ingredients.",
+    }, null, 2);
+}
+function formatNutrition(product) {
+    const nutrients = product.nutrientsInformation;
+    if (!nutrients?.nutrientsTable?.rows)
+        return null;
+    const table = nutrients.nutrientsTable;
+    const headers = table.headers ?? [];
+    const rows = table.rows ?? [];
+    if (rows.length === 0)
+        return null;
+    const headerLabels = headers.map((h) => `${h.label ?? ""}${h.unit ? ` (${h.unit})` : ""}`);
+    const lines = [];
+    lines.push(`| Nutrient | ${headerLabels.join(" | ")} |`);
+    lines.push(`|${"-|".repeat(headerLabels.length + 1)}`);
+    for (const row of rows) {
+        const values = (row.values ?? []).join(" | ");
+        lines.push(`| ${row.label ?? ""} | ${values} |`);
+    }
+    return lines.join("\n");
+}
+function formatProduct(product) {
+    const p = product;
+    const formatted = {
+        uid: p.uid,
+        name: p.name ?? p.title,
+        brand: p.brand,
+        brandLine: p.brandLine,
+        description: p.description,
+        origin: p.origin,
+    };
+    // Price
+    const price = p.price;
+    if (price) {
+        formatted.price = {
+            value: price.value,
+            unitPrice: price.unitPrice,
+            promotionalPrice: price.promotionalPrice,
+        };
+    }
+    // Ratings
+    const ratings = p.ratings;
+    if (ratings) {
+        formatted.ratings = {
+            average: ratings.average,
+            count: ratings.count,
+        };
+    }
+    // Ingredients
+    if (p.ingredients) {
+        formatted.ingredients = p.ingredients;
+    }
+    // Allergens
+    if (p.allergenText) {
+        formatted.allergens = p.allergenText;
+    }
+    // Nutrition table (formatted as markdown)
+    const nutritionTable = formatNutrition(product);
+    if (nutritionTable) {
+        formatted.nutrition = nutritionTable;
+    }
+    // Categories
+    const categories = p.categories;
+    if (categories && categories.length > 0) {
+        formatted.categories = categories.map((c) => c.name ?? c.code).filter(Boolean);
+    }
+    // GTINs
+    if (p.gtins) {
+        formatted.gtins = p.gtins;
+    }
+    // Availability
+    const availability = p.productAvailability;
+    if (availability) {
+        formatted.isAvailable = availability.isAvailable;
+    }
+    return formatted;
+}
+export async function getProductDetails(productIds) {
+    const products = await apiGetProductDetails(productIds);
+    if (!products || products.length === 0) {
+        return JSON.stringify({
+            message: "No product details found for the given IDs",
+            productIds,
+        });
+    }
+    const formatted = products.map(formatProduct);
+    return JSON.stringify(formatted, null, 2);
+}
+export async function getCategories() {
+    const categories = await apiGetCategories();
+    return JSON.stringify(categories, null, 2);
+}
+export async function searchStores(query) {
+    const stores = await apiSearchStores(query);
+    if (!stores || stores.length === 0) {
+        return JSON.stringify({
+            message: `No stores found for "${query}"`,
+        });
+    }
+    return JSON.stringify(stores, null, 2);
+}
+export async function getPromotions(query) {
+    const items = await apiGetPromotions(query);
+    return JSON.stringify(items, null, 2);
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,99 @@
+export interface GuestTokenResponse {
+    token: string;
+}
+export interface ProductSearchResponse {
+    productIds: string[];
+    numberOfProducts: number;
+    categories: unknown[];
+}
+export interface NutrientHeader {
+    label: string;
+    unit: string;
+}
+export interface NutrientRow {
+    label: string;
+    values: string[];
+}
+export interface NutrientsTable {
+    headers: NutrientHeader[];
+    rows: NutrientRow[];
+}
+export interface NutrientsInformation {
+    nutrientsTable?: NutrientsTable;
+}
+export interface ProductDetails {
+    uid: string;
+    miglesId?: string;
+    name?: string;
+    title?: string;
+    description?: string;
+    brand?: string;
+    brandLine?: string;
+    origin?: string;
+    ingredients?: string;
+    allergenText?: string;
+    price?: {
+        value?: number;
+        unitPrice?: string;
+        promotionalPrice?: number;
+    };
+    nutrientsInformation?: NutrientsInformation;
+    ratings?: {
+        average?: number;
+        count?: number;
+    };
+    categories?: Array<{
+        code?: string;
+        name?: string;
+    }>;
+    images?: Array<{
+        url?: string;
+    }>;
+    gtins?: string[];
+    regulatedDescription?: string;
+    productAvailability?: {
+        isAvailable?: boolean;
+    };
+}
+export interface CategoryItem {
+    id?: string;
+    name?: string;
+    slug?: string;
+    children?: CategoryItem[];
+}
+export interface CategoryListResponse {
+    categories: CategoryItem[];
+}
+export interface StoreResult {
+    id?: string;
+    name?: string;
+    address?: {
+        street?: string;
+        zip?: string;
+        city?: string;
+    };
+    location?: {
+        lat?: number;
+        lng?: number;
+    };
+    openingHours?: Array<{
+        day?: string;
+        open?: string;
+        close?: string;
+    }>;
+    type?: string;
+}
+export interface PromotionItem {
+    id?: string;
+    name?: string;
+    description?: string;
+    price?: {
+        value?: number;
+        promotionalPrice?: number;
+    };
+    validFrom?: string;
+    validTo?: string;
+}
+export interface PromotionSearchResponse {
+    items: PromotionItem[];
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "migros-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Migros Switzerland product data, nutrition info, store search, and promotions",
+  "main": "dist/index.js",
+  "bin": {
+    "migros-mcp": "dist/index.js"
+  },
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lewpgs/migros-mcp.git"
+  },
+  "homepage": "https://github.com/lewpgs/migros-mcp",
+  "bugs": {
+    "url": "https://github.com/lewpgs/migros-mcp/issues"
+  },
+  "author": "lewpgs",
+  "keywords": [
+    "mcp",
+    "migros",
+    "switzerland",
+    "grocery",
+    "nutrition",
+    "model-context-protocol"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "migros-api-wrapper": "^1.1.37",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.21",
+    "typescript": "^5.8.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}