shopify-store-mcp 1.0.0

package/dist/graphql/storefront/common/cart.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Storefront API GraphQL queries and mutations for cart operations
+ */
+/**
+ * Create a new cart
+ */
+export declare const STOREFRONT_CREATE_CART = "#graphql\n  mutation StorefrontCreateCart($input: CartInput!) {\n    cartCreate(input: $input) {\n      cart {\n        id\n        checkoutUrl\n        totalQuantity\n        cost {\n          totalAmount {\n            amount\n            currencyCode\n          }\n          subtotalAmount {\n            amount\n            currencyCode\n          }\n          totalTaxAmount {\n            amount\n            currencyCode\n          }\n        }\n        lines(first: 100) {\n          edges {\n            node {\n              id\n              quantity\n              merchandise {\n                ... on ProductVariant {\n                  id\n                  title\n                  product {\n                    title\n                    handle\n                  }\n                  price {\n                    amount\n                    currencyCode\n                  }\n                  image {\n                    url\n                    altText\n                  }\n                }\n              }\n            }\n          }\n        }\n      }\n      userErrors {\n        field\n        message\n      }\n    }\n  }\n";
+/**
+ * Get an existing cart by ID
+ */
+export declare const STOREFRONT_GET_CART = "#graphql\n  query StorefrontGetCart($cartId: ID!) {\n    cart(id: $cartId) {\n      id\n      checkoutUrl\n      totalQuantity\n      cost {\n        totalAmount {\n          amount\n          currencyCode\n        }\n        subtotalAmount {\n          amount\n          currencyCode\n        }\n        totalTaxAmount {\n          amount\n          currencyCode\n        }\n      }\n      lines(first: 100) {\n        edges {\n          node {\n            id\n            quantity\n            merchandise {\n              ... on ProductVariant {\n                id\n                title\n                product {\n                  title\n                  handle\n                }\n                price {\n                  amount\n                  currencyCode\n                }\n                image {\n                  url\n                  altText\n                }\n              }\n            }\n          }\n        }\n      }\n      buyerIdentity {\n        email\n        phone\n        countryCode\n      }\n    }\n  }\n";
+/**
+ * Add lines to an existing cart
+ */
+export declare const STOREFRONT_ADD_CART_LINES = "#graphql\n  mutation StorefrontAddCartLines($cartId: ID!, $lines: [CartLineInput!]!) {\n    cartLinesAdd(cartId: $cartId, lines: $lines) {\n      cart {\n        id\n        totalQuantity\n        cost {\n          totalAmount {\n            amount\n            currencyCode\n          }\n        }\n        lines(first: 100) {\n          edges {\n            node {\n              id\n              quantity\n              merchandise {\n                ... on ProductVariant {\n                  id\n                  title\n                }\n              }\n            }\n          }\n        }\n      }\n      userErrors {\n        field\n        message\n      }\n    }\n  }\n";
+/**
+ * Update lines in an existing cart
+ */
+export declare const STOREFRONT_UPDATE_CART_LINES = "#graphql\n  mutation StorefrontUpdateCartLines($cartId: ID!, $lines: [CartLineUpdateInput!]!) {\n    cartLinesUpdate(cartId: $cartId, lines: $lines) {\n      cart {\n        id\n        totalQuantity\n        cost {\n          totalAmount {\n            amount\n            currencyCode\n          }\n        }\n        lines(first: 100) {\n          edges {\n            node {\n              id\n              quantity\n            }\n          }\n        }\n      }\n      userErrors {\n        field\n        message\n      }\n    }\n  }\n";
+/**
+ * Remove lines from an existing cart
+ */
+export declare const STOREFRONT_REMOVE_CART_LINES = "#graphql\n  mutation StorefrontRemoveCartLines($cartId: ID!, $lineIds: [ID!]!) {\n    cartLinesRemove(cartId: $cartId, lineIds: $lineIds) {\n      cart {\n        id\n        totalQuantity\n        cost {\n          totalAmount {\n            amount\n            currencyCode\n          }\n        }\n      }\n      userErrors {\n        field\n        message\n      }\n    }\n  }\n";

package/dist/graphql/storefront/common/cart.js

@@ -0,0 +1,210 @@
+/**
+ * Storefront API GraphQL queries and mutations for cart operations
+ */
+/**
+ * Create a new cart
+ */
+export const STOREFRONT_CREATE_CART = `#graphql
+  mutation StorefrontCreateCart($input: CartInput!) {
+    cartCreate(input: $input) {
+      cart {
+        id
+        checkoutUrl
+        totalQuantity
+        cost {
+          totalAmount {
+            amount
+            currencyCode
+          }
+          subtotalAmount {
+            amount
+            currencyCode
+          }
+          totalTaxAmount {
+            amount
+            currencyCode
+          }
+        }
+        lines(first: 100) {
+          edges {
+            node {
+              id
+              quantity
+              merchandise {
+                ... on ProductVariant {
+                  id
+                  title
+                  product {
+                    title
+                    handle
+                  }
+                  price {
+                    amount
+                    currencyCode
+                  }
+                  image {
+                    url
+                    altText
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+      userErrors {
+        field
+        message
+      }
+    }
+  }
+`;
+/**
+ * Get an existing cart by ID
+ */
+export const STOREFRONT_GET_CART = `#graphql
+  query StorefrontGetCart($cartId: ID!) {
+    cart(id: $cartId) {
+      id
+      checkoutUrl
+      totalQuantity
+      cost {
+        totalAmount {
+          amount
+          currencyCode
+        }
+        subtotalAmount {
+          amount
+          currencyCode
+        }
+        totalTaxAmount {
+          amount
+          currencyCode
+        }
+      }
+      lines(first: 100) {
+        edges {
+          node {
+            id
+            quantity
+            merchandise {
+              ... on ProductVariant {
+                id
+                title
+                product {
+                  title
+                  handle
+                }
+                price {
+                  amount
+                  currencyCode
+                }
+                image {
+                  url
+                  altText
+                }
+              }
+            }
+          }
+        }
+      }
+      buyerIdentity {
+        email
+        phone
+        countryCode
+      }
+    }
+  }
+`;
+/**
+ * Add lines to an existing cart
+ */
+export const STOREFRONT_ADD_CART_LINES = `#graphql
+  mutation StorefrontAddCartLines($cartId: ID!, $lines: [CartLineInput!]!) {
+    cartLinesAdd(cartId: $cartId, lines: $lines) {
+      cart {
+        id
+        totalQuantity
+        cost {
+          totalAmount {
+            amount
+            currencyCode
+          }
+        }
+        lines(first: 100) {
+          edges {
+            node {
+              id
+              quantity
+              merchandise {
+                ... on ProductVariant {
+                  id
+                  title
+                }
+              }
+            }
+          }
+        }
+      }
+      userErrors {
+        field
+        message
+      }
+    }
+  }
+`;
+/**
+ * Update lines in an existing cart
+ */
+export const STOREFRONT_UPDATE_CART_LINES = `#graphql
+  mutation StorefrontUpdateCartLines($cartId: ID!, $lines: [CartLineUpdateInput!]!) {
+    cartLinesUpdate(cartId: $cartId, lines: $lines) {
+      cart {
+        id
+        totalQuantity
+        cost {
+          totalAmount {
+            amount
+            currencyCode
+          }
+        }
+        lines(first: 100) {
+          edges {
+            node {
+              id
+              quantity
+            }
+          }
+        }
+      }
+      userErrors {
+        field
+        message
+      }
+    }
+  }
+`;
+/**
+ * Remove lines from an existing cart
+ */
+export const STOREFRONT_REMOVE_CART_LINES = `#graphql
+  mutation StorefrontRemoveCartLines($cartId: ID!, $lineIds: [ID!]!) {
+    cartLinesRemove(cartId: $cartId, lineIds: $lineIds) {
+      cart {
+        id
+        totalQuantity
+        cost {
+          totalAmount {
+            amount
+            currencyCode
+          }
+        }
+      }
+      userErrors {
+        field
+        message
+      }
+    }
+  }
+`;
+//# sourceMappingURL=cart.js.map

package/dist/graphql/storefront/common/collections.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Storefront API GraphQL queries for collection browsing
+ */
+/**
+ * Get a paginated list of collections for storefront display
+ */
+export declare const STOREFRONT_GET_COLLECTIONS = "#graphql\n  query StorefrontGetCollections($first: Int!, $after: String) {\n    collections(first: $first, after: $after) {\n      edges {\n        node {\n          id\n          title\n          handle\n          description\n          image {\n            url\n            altText\n            width\n            height\n          }\n          products(first: 4) {\n            edges {\n              node {\n                id\n                title\n                handle\n                featuredImage {\n                  url\n                  altText\n                }\n                priceRange {\n                  minVariantPrice {\n                    amount\n                    currencyCode\n                  }\n                }\n              }\n            }\n          }\n        }\n        cursor\n      }\n      pageInfo {\n        hasNextPage\n        endCursor\n      }\n    }\n  }\n";
+/**
+ * Get a single collection by handle with its products
+ */
+export declare const STOREFRONT_GET_COLLECTION_BY_HANDLE = "#graphql\n  query StorefrontGetCollectionByHandle($handle: String!, $first: Int!, $after: String) {\n    collectionByHandle(handle: $handle) {\n      id\n      title\n      handle\n      description\n      descriptionHtml\n      image {\n        url\n        altText\n        width\n        height\n      }\n      products(first: $first, after: $after) {\n        edges {\n          node {\n            id\n            title\n            handle\n            description\n            availableForSale\n            featuredImage {\n              url\n              altText\n              width\n              height\n            }\n            priceRange {\n              minVariantPrice {\n                amount\n                currencyCode\n              }\n              maxVariantPrice {\n                amount\n                currencyCode\n              }\n            }\n            variants(first: 1) {\n              edges {\n                node {\n                  id\n                  price {\n                    amount\n                    currencyCode\n                  }\n                }\n              }\n            }\n          }\n          cursor\n        }\n        pageInfo {\n          hasNextPage\n          endCursor\n        }\n      }\n    }\n  }\n";

package/dist/graphql/storefront/common/collections.js

@@ -0,0 +1,114 @@
+/**
+ * Storefront API GraphQL queries for collection browsing
+ */
+/**
+ * Get a paginated list of collections for storefront display
+ */
+export const STOREFRONT_GET_COLLECTIONS = `#graphql
+  query StorefrontGetCollections($first: Int!, $after: String) {
+    collections(first: $first, after: $after) {
+      edges {
+        node {
+          id
+          title
+          handle
+          description
+          image {
+            url
+            altText
+            width
+            height
+          }
+          products(first: 4) {
+            edges {
+              node {
+                id
+                title
+                handle
+                featuredImage {
+                  url
+                  altText
+                }
+                priceRange {
+                  minVariantPrice {
+                    amount
+                    currencyCode
+                  }
+                }
+              }
+            }
+          }
+        }
+        cursor
+      }
+      pageInfo {
+        hasNextPage
+        endCursor
+      }
+    }
+  }
+`;
+/**
+ * Get a single collection by handle with its products
+ */
+export const STOREFRONT_GET_COLLECTION_BY_HANDLE = `#graphql
+  query StorefrontGetCollectionByHandle($handle: String!, $first: Int!, $after: String) {
+    collectionByHandle(handle: $handle) {
+      id
+      title
+      handle
+      description
+      descriptionHtml
+      image {
+        url
+        altText
+        width
+        height
+      }
+      products(first: $first, after: $after) {
+        edges {
+          node {
+            id
+            title
+            handle
+            description
+            availableForSale
+            featuredImage {
+              url
+              altText
+              width
+              height
+            }
+            priceRange {
+              minVariantPrice {
+                amount
+                currencyCode
+              }
+              maxVariantPrice {
+                amount
+                currencyCode
+              }
+            }
+            variants(first: 1) {
+              edges {
+                node {
+                  id
+                  price {
+                    amount
+                    currencyCode
+                  }
+                }
+              }
+            }
+          }
+          cursor
+        }
+        pageInfo {
+          hasNextPage
+          endCursor
+        }
+      }
+    }
+  }
+`;
+//# sourceMappingURL=collections.js.map

package/dist/graphql/storefront/common/products.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Storefront API GraphQL queries for product browsing
+ * These queries are meant for customer-facing operations
+ */
+/**
+ * Get a paginated list of products for storefront display
+ * Includes pricing, images, and availability
+ */
+export declare const STOREFRONT_GET_PRODUCTS = "#graphql\n  query StorefrontGetProducts($first: Int!, $after: String, $query: String) {\n    products(first: $first, after: $after, query: $query) {\n      edges {\n        node {\n          id\n          title\n          handle\n          description\n          productType\n          vendor\n          tags\n          availableForSale\n          priceRange {\n            minVariantPrice {\n              amount\n              currencyCode\n            }\n            maxVariantPrice {\n              amount\n              currencyCode\n            }\n          }\n          compareAtPriceRange {\n            minVariantPrice {\n              amount\n              currencyCode\n            }\n            maxVariantPrice {\n              amount\n              currencyCode\n            }\n          }\n          images(first: 5) {\n            edges {\n              node {\n                url\n                altText\n                width\n                height\n              }\n            }\n          }\n          variants(first: 10) {\n            edges {\n              node {\n                id\n                title\n                availableForSale\n                price {\n                  amount\n                  currencyCode\n                }\n                compareAtPrice {\n                  amount\n                  currencyCode\n                }\n              }\n            }\n          }\n        }\n        cursor\n      }\n      pageInfo {\n        hasNextPage\n        endCursor\n      }\n    }\n  }\n";
+/**
+ * Get a single product by handle for storefront display
+ * Includes full variant details with inventory availability
+ */
+export declare const STOREFRONT_GET_PRODUCT_BY_HANDLE = "#graphql\n  query StorefrontGetProductByHandle($handle: String!) {\n    productByHandle(handle: $handle) {\n      id\n      title\n      handle\n      description\n      descriptionHtml\n      productType\n      vendor\n      tags\n      availableForSale\n      options {\n        id\n        name\n        values\n      }\n      priceRange {\n        minVariantPrice {\n          amount\n          currencyCode\n        }\n        maxVariantPrice {\n          amount\n          currencyCode\n        }\n      }\n      images(first: 20) {\n        edges {\n          node {\n            url\n            altText\n            width\n            height\n          }\n        }\n      }\n      variants(first: 100) {\n        edges {\n          node {\n            id\n            title\n            availableForSale\n            quantityAvailable\n            price {\n              amount\n              currencyCode\n            }\n            compareAtPrice {\n              amount\n              currencyCode\n            }\n            selectedOptions {\n              name\n              value\n            }\n            image {\n              url\n              altText\n            }\n          }\n        }\n      }\n      metafields(identifiers: []) {\n        key\n        namespace\n        value\n        type\n      }\n    }\n  }\n";

package/dist/graphql/storefront/common/products.js

@@ -0,0 +1,155 @@
+/**
+ * Storefront API GraphQL queries for product browsing
+ * These queries are meant for customer-facing operations
+ */
+/**
+ * Get a paginated list of products for storefront display
+ * Includes pricing, images, and availability
+ */
+export const STOREFRONT_GET_PRODUCTS = `#graphql
+  query StorefrontGetProducts($first: Int!, $after: String, $query: String) {
+    products(first: $first, after: $after, query: $query) {
+      edges {
+        node {
+          id
+          title
+          handle
+          description
+          productType
+          vendor
+          tags
+          availableForSale
+          priceRange {
+            minVariantPrice {
+              amount
+              currencyCode
+            }
+            maxVariantPrice {
+              amount
+              currencyCode
+            }
+          }
+          compareAtPriceRange {
+            minVariantPrice {
+              amount
+              currencyCode
+            }
+            maxVariantPrice {
+              amount
+              currencyCode
+            }
+          }
+          images(first: 5) {
+            edges {
+              node {
+                url
+                altText
+                width
+                height
+              }
+            }
+          }
+          variants(first: 10) {
+            edges {
+              node {
+                id
+                title
+                availableForSale
+                price {
+                  amount
+                  currencyCode
+                }
+                compareAtPrice {
+                  amount
+                  currencyCode
+                }
+              }
+            }
+          }
+        }
+        cursor
+      }
+      pageInfo {
+        hasNextPage
+        endCursor
+      }
+    }
+  }
+`;
+/**
+ * Get a single product by handle for storefront display
+ * Includes full variant details with inventory availability
+ */
+export const STOREFRONT_GET_PRODUCT_BY_HANDLE = `#graphql
+  query StorefrontGetProductByHandle($handle: String!) {
+    productByHandle(handle: $handle) {
+      id
+      title
+      handle
+      description
+      descriptionHtml
+      productType
+      vendor
+      tags
+      availableForSale
+      options {
+        id
+        name
+        values
+      }
+      priceRange {
+        minVariantPrice {
+          amount
+          currencyCode
+        }
+        maxVariantPrice {
+          amount
+          currencyCode
+        }
+      }
+      images(first: 20) {
+        edges {
+          node {
+            url
+            altText
+            width
+            height
+          }
+        }
+      }
+      variants(first: 100) {
+        edges {
+          node {
+            id
+            title
+            availableForSale
+            quantityAvailable
+            price {
+              amount
+              currencyCode
+            }
+            compareAtPrice {
+              amount
+              currencyCode
+            }
+            selectedOptions {
+              name
+              value
+            }
+            image {
+              url
+              altText
+            }
+          }
+        }
+      }
+      metafields(identifiers: []) {
+        key
+        namespace
+        value
+        type
+      }
+    }
+  }
+`;
+//# sourceMappingURL=products.js.map

package/dist/graphql/storefront/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Storefront API GraphQL queries and mutations
+ * Re-exports all queries organized by domain
+ */
+export * from "./common/products.js";
+export * from "./common/collections.js";
+export * from "./common/cart.js";

package/dist/graphql/storefront/index.js

@@ -0,0 +1,8 @@
+/**
+ * Storefront API GraphQL queries and mutations
+ * Re-exports all queries organized by domain
+ */
+export * from "./common/products.js";
+export * from "./common/collections.js";
+export * from "./common/cart.js";
+//# sourceMappingURL=index.js.map

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+// Set default DATABASE_URL before any imports that use Prisma
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+import { existsSync, mkdirSync } from "fs";
+import { homedir } from "os";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Default to a database file in ~/.shopify-mcp/ directory
+if (!process.env.DATABASE_URL) {
+    const dbDir = join(homedir(), ".shopify-mcp");
+    if (!existsSync(dbDir)) {
+        mkdirSync(dbDir, { recursive: true });
+    }
+    process.env.DATABASE_URL = `file:${join(dbDir, "mcp.db")}`;
+}
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { loadConfig } from "./config.js";
+import { getAdminClient } from "./shopify-client.js";
+import { registerAllTools } from "./tools/index.js";
+import { registerAllPrompts } from "./prompts/index.js";
+import { registerAllResources } from "./resources/index.js";
+// Database and queue
+import prisma, { initializeDatabase, cleanupOldLogs } from "./db.js";
+import { updateQueue, getCurrentTierInfo } from "./queue.js";
+import { getSessionId } from "./logger.js";
+async function main() {
+    const config = loadConfig();
+    // Initialize database
+    await initializeDatabase();
+    // Load stored config and set up queue
+    const storedConfig = await prisma.storeConfig.findUnique({
+        where: { storeDomain: config.storeDomain },
+    });
+    // Use stored tier, env var, or default to STANDARD
+    const tier = storedConfig?.tier ||
+        process.env.SHOPIFY_TIER ||
+        "STANDARD";
+    updateQueue(tier);
+    // Clean up old logs if configured
+    const retentionDays = parseInt(process.env.MCP_LOG_RETENTION_DAYS || "30", 10);
+    if (retentionDays > 0) {
+        const deleted = await cleanupOldLogs(retentionDays);
+        if (deleted > 0) {
+            console.error(`[shopify-store-mcp] Cleaned up ${deleted} old log entries`);
+        }
+    }
+    const adminClient = getAdminClient(config);
+    // Verify API connection on startup
+    try {
+        const healthCheck = await adminClient.request(`query { shop { name } }`);
+        if (healthCheck.errors) {
+            const errObj = healthCheck.errors;
+            if (errObj.networkStatusCode === 401) {
+                console.error(`[shopify-store-mcp] ERROR: Invalid access token. Check SHOPIFY_ACCESS_TOKEN.`);
+                console.error(`[shopify-store-mcp] Make sure the token belongs to store: ${config.storeDomain}`);
+            }
+            else if (errObj.networkStatusCode === 403) {
+                console.error(`[shopify-store-mcp] ERROR: Token lacks required scopes.`);
+            }
+            else {
+                console.error(`[shopify-store-mcp] ERROR: API connection failed:`, healthCheck.errors);
+            }
+            process.exit(1);
+        }
+        const shopName = healthCheck.data?.shop?.name;
+        console.error(`[shopify-store-mcp] API connection verified: ${shopName}`);
+    }
+    catch (error) {
+        console.error(`[shopify-store-mcp] ERROR: Failed to connect to Shopify API:`, error);
+        process.exit(1);
+    }
+    const server = new McpServer({
+        name: "shopify-store-mcp",
+        version: "1.0.0",
+    });
+    // Register all capabilities
+    registerAllTools(server, adminClient, config.storeDomain);
+    registerAllPrompts(server);
+    registerAllResources(server, config);
+    // Connect via stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log startup info
+    const tierInfo = getCurrentTierInfo();
+    console.error(`[shopify-store-mcp] Connected to store: ${config.storeDomain}`);
+    console.error(`[shopify-store-mcp] API version: ${config.apiVersion}`);
+    console.error(`[shopify-store-mcp] Rate limit tier: ${tierInfo.tier} (${tierInfo.config.intervalCap} req/sec)`);
+    console.error(`[shopify-store-mcp] Session ID: ${getSessionId()}`);
+    console.error(`[shopify-store-mcp] Tools: 10 (run 'schema_discover' to explore store schema)`);
+}
+main().catch((error) => {
+    console.error("[shopify-store-mcp] Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map