Shopify MCP Server Cci

一個為Shopify與LLM代理集成設計的MCP服務器，提供訂單處理、物流跟蹤、歸檔和查詢等功能。

電子商務與零售開發者工具 #Shopify集成 #訂單管理 #物流跟蹤 #MCP協議 Local .TypeScript

rating : 2 points

downloads : 21

update time : 2025-04-23

什麼是Shopify MCP服務器？

Shopify MCP服務器是一個用於集成Shopify操作的工具，它通過Model Context Protocol（MCP）協議連接LLM（大型語言模型），實現自動化處理訂單任務，例如創建發貨、添加跟蹤信息、歸檔歷史訂單等。

如何使用Shopify MCP服務器？

只需簡單配置並運行服務器，即可通過命令行或API接口操作Shopify訂單。無需手動登錄Shopify後臺，簡化工作流程。

適用場景

適合需要頻繁處理Shopify訂單的商家或開發者，尤其在需要與AI助手協同工作的場景下。

主要功能

獲取訂單詳情根據訂單號（#1001）獲取詳細的訂單信息。

請求發貨一鍵發起訂單發貨，支持直接填寫跟蹤信息。

添加跟蹤信息更新已發貨訂單的物流追蹤狀態。

歸檔訂單將已完成或無需處理的訂單存檔。

列出活躍訂單查看當前未完成的訂單列表。

優勢與侷限性

優勢

支持多種操作，覆蓋訂單生命週期全過程。

使用MCP協議，易於與LLM集成。

自動解析訂單ID，無需記憶複雜格式。

避免手動訪問Shopify後臺，提升效率。

侷限性

需要Shopify API權限（如讀寫訂單）。

可能因API版本更新導致功能調整。

不支持個人隱私數據（如客戶地址）。

如何使用

安裝依賴

克隆倉庫並運行npm install安裝項目依賴。

配置環境變量

編輯.env文件並填寫Shopify API密鑰及訪問令牌。

啟動服務器

運行npm start開始監聽訂單操作。

使用案例

查詢訂單詳情通過get-order-details命令獲取訂單#1001的信息。

批量發貨使用request-fulfillment命令處理多個未完成訂單。

常見問題

是否需要額外付費才能使用Shopify MCP服務器？

如何確保API版本兼容性？

是否支持敏感數據操作？

🚀 Shopify MCP 服務器

Shopify MCP 服務器是一個基於 Model Context Protocol (MCP) 的工具，它能將 Shopify 運營與 LLM 代理完美集成。藉助該服務器，你可以輕鬆處理 Shopify 訂單，涵蓋履行訂單、添加跟蹤信息、存檔以及檢索訂單等功能。

🚀 快速開始

本服務器可助力你高效處理 Shopify 訂單，涵蓋履行、添加跟蹤信息、存檔和檢索等操作。

✨ 主要特性

請求訂單履行：可發起訂單履行請求。
添加訂單跟蹤信息：為訂單添加跟蹤信息。
存檔訂單：將指定訂單進行存檔。
獲取特定訂單的詳細信息：查詢特定訂單的詳細內容。
列出所有活躍訂單：展示所有活躍狀態的訂單。

📦 安裝指南

安裝前準備

需安裝 Node.js 18 或更高版本。
擁有具備 API 訪問權限的 Shopify 商店。

安裝步驟

克隆倉庫：

git clone https://github.com/yourusername/shopify-mcp-server.git
cd shopify-mcp-server

安裝依賴項：
```
npm install
```

基於 .env.example 創建一個 .env 文件，並添加您的 Shopify API 憑證：

SHOPIFY_API_KEY=your_api_key
SHOPIFY_API_SECRET=your_api_secret
SHOPIFY_SCOPES=write_orders,read_orders
SHOPIFY_SHOP=your-shop.myshopify.com
SHOPIFY_ACCESS_TOKEN=your_access_token

構建和運行

構建項目：
```
npm run build
```
啟動服務器：
```
npm start
```
使用自動重新構建進行開發：
```
npm run dev
```

💻 使用示例

基礎用法

此服務器實現 Model Context Protocol (MCP) 並公開以下工具：

get-order-details：獲取特定訂單的詳細信息（接受帶友好編號格式的訂單號，如 "#1001"）
get-active-orders：獲取所有活躍訂單的列表
request-fulfillment：請求履行訂單，可選添加跟蹤信息（接受友好訂單號）
add-tracking：向已履行的訂單添加跟蹤信息
archive-order：存檔一個訂單（接受友好訂單號）

高級用法

使用友好的訂單號

所有需要訂單 ID 的工具現在都支持友好訂單號：

#1001 - 帶有井號前綴的訂單號
1001 - 不帶井號前綴的訂單號
完整的 Shopify ID（例如 gid://shopify/Order/12345）- 仍然支持

系統會自動查找正確的 Shopify ID，當您提供友好格式的訂單號時。

更新跟蹤信息

要更新訂單的跟蹤信息，請按照以下步驟操作：

首先，使用 get-order-details 工具獲取訂單詳細信息（例如，使用訂單號 "#1001"）
從響應中，在“履行”部分找到履行 ID

使用 add-tracking 工具並提供履行 ID 和跟蹤信息：

{
  "fulfillmentId": "gid://shopify/Fulfillment/123456789",
  "trackingNumber": "1Z999AA10123456789",
  "trackingCompany": "UPS",
  "trackingUrl": "https://www.ups.com/track?tracknum=1Z999AA10123456789",
  "notifyCustomer": true
}