Shopify MCP Server For Claude Desktop

🚀 Shopify MCP 服務器用於 Claude 桌面版

這是一個簡單的模型上下文協議（MCP）服務器，它能將您的 Shopify 店鋪數據連接到 Claude 桌面版，讓 Claude 可以訪問您的商店信息。

🚀 快速開始

本服務器可將您的 Shopify 店鋪數據與 Claude 桌面版相連接，使 Claude 能夠訪問您的店鋪信息。以下是具體的使用步驟。

📦 安裝指南

1. 安裝依賴項：

   npm install
   

2. 創建一個 .env 文件，添加您的 Shopify 憑據：

   SHOPIFY_STORE_NAME=your-store-name
   SHOPIFY_API_ACCESS_TOKEN=your-access-token
   

3. 構建 TypeScript 代碼：

   npm run build
   

4. 運行 MCP 服務器：

   npm start
   

5. 在 Claude 桌面版中，設置 MCP 服務器指向此服務器。現在您應該能夠訪問您的 Shopify 數據。

✨ 主要特性

此服務器通過 MCP 工具提供以下 Shopify 功能：

產品工具

• create_product：此工具創建具有選項（例如顏色、尺寸）的產品結構，並將狀態設為 DRAFT。它處理產品標題、描述、供應商、類型、標籤和選項配置，但不創建帶有價格的變體。這是產品創建的第一步。

• browse_products：此工具檢索產品的列表，可選包含庫存信息。它支持分頁並提供關鍵產品詳細信息，如標題、描述、圖像、變體和庫存狀態。當提供特定的 product_id 時，它返回該單個產品的詳細信息。

• update_variant_price：此工具更新特定產品變體的價格和/或比較價格。它可以設置新的常規價格、添加/更新比較價格或通過傳遞 null 或空字符串移除比較價格。

庫存工具

• list_inventory_items：此工具檢索庫存項目的列表，可選按 SKU 過濾。它支持分頁並提供庫存詳細信息，如可用數量、成本和庫存位置。

• get_inventory_item：此工具檢索特定庫存項目（按 ID 或 SKU）的詳細信息。它返回全面的庫存數據，包括是否跟蹤、所有位置的可用數量以及關聯的變體信息。

• update_inventory_quantity：此工具更新特定位置的庫存項目的可用數量。它接受庫存項目 ID、位置 ID 和新可用數量，並返回調整後的庫存水平。

訂單工具

• browse_orders：此工具檢索 Shopify 訂單，帶有強大的過濾選項。它支持按狀態、日期範圍、客戶電子郵件、財務狀態和履行狀態進行過濾，並允許通過訂單號或客戶詳細信息搜索。當提供特定的 order_id 時，它返回該單個訂單的詳細信息。

客戶工具

• browse_customers：此工具檢索客戶信息和消費數據，帶有高級過濾選項。它支持按多個字段排序、按最小/最大消費過濾，並返回詳細的客戶配置文件。當提供特定的 customer_id 時，它返回該單個客戶的全面信息。

媒體工具

• upload_image_from_url：此工具從公開 URL 上傳圖像到 Shopify CDN 文件部分。它處理將圖像數據傳輸到 Shopify 服務器，並允許指定 alt 文本和可選文件名。

放棄工具

• get_abandonment：此工具檢索特定購物車或結賬放棄的詳細信息。它返回有關 abandoned 購物車的數據，包括項目、價格、客戶信息（如有）以及 abandon timing。您可以自定義響應中返回的字段。

GraphQL 工具

• query_shopify：此工具執行 Shopify 管理 API 的自定義 GraphQL 查詢或突變。它允許完全靈活地訪問任何未被專業工具覆蓋的 Shopify 管理 API 終端點，並提供傳遞變量和啟用突變操作的選項。

• introspect_admin_schema：此工具 introspects 並返回與用戶提示相關的 Shopify 管理 API GraphQL 模式的部分。僅用於 Shopify 管理 API，而不用於其他任何 API，如 Shopify 前臺 API 或 Shopify Functions API。它接受搜索詞以按名稱過濾模式元素，並提供選項專注於特定部分，例如類型、查詢或突變。

📄 許可證

MIT