Newshopify MCP Server

🚀 Shopify 管理 GraphQL MCP 服務器

這是一個全面的 Model Context Protocol (MCP) 服務器，專門用於與 Shopify 的管理 GraphQL API 進行交互。它提供了豐富的工具和資源，可用於管理產品、訂單、客戶、庫存、折扣、元字段以及商店信息，為 Shopify 管理提供了一站式解決方案。

✨ 主要特性

• 全面覆蓋關鍵的 Shopify 管理 API 功能，滿足各種管理需求。
• 提供結構化工具，適用於所有主要的 Shopify 資源，方便操作。
• 每個 API 部分都配備文檔資源，便於開發者查閱。
• 易於與任何 MCP 兼容客戶端配合使用，提升開發效率。

📦 安裝指南

1. 克隆此倉庫。
2. 安裝依賴項：

npm install

3. 使用你的 Shopify 資格創建一個 .env 文件：

SHOPIFY_SHOP_NAME=your-shop-name
SHOPIFY_ACCESS_TOKEN=your-access-token

💻 使用示例

基礎用法

啟動服務器：

npm run dev

使用 MCP 檢查器測試：

npm run inspect

高級用法

本服務器提供了豐富的工具，可用於管理不同的 Shopify 資源，以下是各資源的可用工具及使用說明：

產品

• getProduct：按 ID 獲取產品。
• listProducts：列出產品，支持分頁。
• createProduct：創建新商品。
• updateProduct：更新現有產品。
• deleteProduct：刪除產品。

訂單

• getOrder：按 ID 獲取訂單。
• listOrders：列出訂單，支持分頁。
• cancelOrder：取消訂單。

客戶

• getCustomer：按 ID 獲取客戶。
• listCustomers：列出客戶，支持分頁。
• createCustomer：創建新客戶。
• updateCustomer：更新現有客戶。
• deleteCustomer：刪除客戶。

庫存

• getInventoryItem：按 ID 獲取庫存項。
• adjustInventory：調整庫存水平。
• getInventoryLevel：獲取位置和項目的庫存級別。

折扣

• getDiscount：按 ID 獲取折扣。
• createDiscount：創建基本折扣碼。
• deleteDiscount：刪除折扣。

元字段

• getMetafield：按 ID 獲取元字段。
• createProductMetafield：為產品創建元字段。
• deleteMetafield：刪除元字段。

商店

• getShopInfo：獲取有關您商店的信息。
• updateShopInfo：更新商店信息。

📚 詳細文檔

通過訪問 shopify://docs/{section} 資源，可獲取詳細的文檔說明，其中部分可以是：

• overview
• products
• orders
• customers
• inventory
• discounts
• metafields
• shop

🔧 技術細節

此服務器需要 Shopify 管理 API 訪問令牌。您可以在 Shopify 管理界面的 Apps > 開發應用下創建一個。