Shopify MCP Server Cci

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

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

評分 : 2分

下載量 : 6.1K

更新時間 : 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
}