Shopify Storefront MCP Server

🚀 Shopify店鋪指南

本指南詳細介紹瞭如何藉助MCP（多渠道平臺）服務器與Shopify店鋪進行交互。涵蓋功能概述、設置說明、環境變量配置、Storefront API令牌生成步驟、使用示例、客戶資源管理以及數據隱私與存儲策略等內容，助您高效管理Shopify店鋪。

✨ 主要特性

• 商品信息查詢：可獲取所有產品及其詳細信息。
• 購物車管理：支持添加、修改和刪除購物車中的商品。
• 訂單操作：能創建新訂單或查看現有訂單的狀態。
• 庫存同步：確保本地庫存與Shopify店鋪的庫存保持一致。
• 價格規則應用：可應用促銷活動和定價策略。

📦 安裝指南

安裝依賴項

使用以下命令安裝所需包：

npm install shopify-api

配置環境變量

編輯.env文件，添加如下配置：

SHOPIFY_STORE_NAME=your-store.myshopify.com
SHOPIFY_API_KEY=your_api_key
SHOPIFY_API_SECRET=your_api_secret

初始化數據庫

運行以下命令創建本地數據庫表：

npx knex migrate:latest

💻 使用示例

基礎用法

查詢商品信息

使用以下GraphQL查詢獲取所有產品：

query {
  products(first: 10) {
    edges {
      node {
        id
        title
        description
        price
      }
    }
  }
}

創建購物車

調用以下REST API創建新購物車：

POST /api/2025-04/graphql.json
{
  "query": "mutation createCart($lines: [CartLineInput!]!) {
    cartCreate(input: { lines: $lines }) {
      cart {
        id
        checkoutUrl
      }
      userErrors {
        field
        message
      }
    }
  }",
  "variables": {
    "lines": [
      {
        "merchandiseId": "gid://shopify/ProductVariant/12345678901234",
        "quantity": 1
      }
    ]
  }
}

高級用法

應用優惠券

使用以下突變應用指定的優惠券：

mutation applyCoupon($cartId: ID!, $couponCode: String!) {
  cartUpdate(id: $cartId, updates: { couponCode: $couponCode }) {
    cart {
      id
      totalAmount
    }
    userErrors {
      field
      message
    }
  }
}

📚 詳細文檔

客戶資源管理

數據結構

客戶數據存儲在db/customers.json文件中，包含以下字段：

• id: 唯一標識符
• firstName: 名字
• lastName: 姓氏
• email: 郵箱地址
• address: 收貨地址

數據操作

添加新客戶

const newCustomer = {
  id: generateUUID(),
  firstName: "John",
  lastName: "Doe",
  email: "john.doe@example.com",
  address: "123 Main St, City"
};
db.customers.push(newCustomer);

更新現有客戶

const customer = db.customers.find(c => c.id === customerId);
if (customer) {
  customer.firstName = "Jane";
  customer.lastName = "Smith";
}

數據隱私與存儲

文件管理

• 數據文件：db/customers.json
• 示例文件：db/customers.json.example提供了一個模板，包含虛構的客戶數據。

安全措施

1. 禁止將敏感文件如.env和db/customers.json提交到版本控制系統。
2. 使用加密技術保護客戶的個人信息。
3. 定期備份數據庫以防止數據丟失。

故障排除

問題：無法連接到Shopify店鋪

解決方案：

1. 檢查網絡連接是否正常。
2. 確保API密鑰和秘鑰正確無誤。
3. 查看Shopify的開發者文檔以獲取更多幫助。

問題：購物車創建失敗

解決方案：

1. 驗證傳遞的參數是否符合要求。
2. 確認商品是否存在且庫存充足。
3. 檢查日誌文件以獲取詳細錯誤信息。

總結

本指南提供了與Shopify店鋪交互的基本方法，涵蓋了從數據查詢到客戶管理的各個方面。通過遵循這些步驟和最佳實踐，您可以有效地集成和管理您的 Shopify 店鋪。