Shopify

🚀 Shopify MCP 服務器

Shopify MCP 服務器是基於 Model Context Protocol (MCP) 的工具，可與 Shopify 商店交互。它提供一系列 GraphQL API 接口，便於開發者管理商品、客戶、訂單等數據。

🚀 快速開始

Shopify 訪問令牌

若要使用本服務器，需按以下步驟創建自定義應用並獲取訪問令牌：

1. 登錄 Shopify 管理界面。
2. 進入 設置 > 應用和銷售渠道。
3. 點擊 開發應用（可能需先啟用開發者預覽）。
4. 創建新應用，命名為“Shopify MCP 服務器”或其他易記名稱。
5. 配置 Admin API 權限範圍：
   • 讀取和寫入商品 (read_products, write_products)
   • 讀取和寫入客戶 (read_customers, write_customers)
   • 讀取和寫入訂單 (read_orders, write_orders)
6. 安裝應用並獲取 Admin API 訪問令牌。

⚠️ 重要提示

請妥善保管訪問令牌，避免洩露或誤傳至版本控制系統。

✨ 主要特性

• 強大的 GraphQL 支持：通過 GraphQL 請求直接操作 Shopify 數據。
• 靈活的 MCP 協議：利用 MCP 的上下文模型協議實現高效的數據交互。
• 多場景支持：適用於商品管理、客戶關係維護、訂單處理等多種業務場景。

📦 安裝指南

項目結構

1. 克隆倉庫：

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

2. 安裝依賴：

npm install

3. 創建 .env 文件：

SHOPIFY_ACCESS_TOKEN=<你的訪問令牌>
MYSHOPIFY_DOMAIN=<your-store>.myshopify.com

4. 啟動開發服務器：

npm start

依賴項

• graphql：GraphQL 客戶端庫。
• axios：HTTP 請求庫。
• dotenv：環境變量加載工具。

💻 使用示例

基礎用法

在 Claude Desktop 中使用本服務器：

1. 創建或編輯 claude_desktop_config.json 文件。
2. 添加以下配置：

{
    "mcpServers": {
        "shopify": {
            "command": "npx",
            "args": ["-y", "shopify-mcp-server"],
            "env": {
                "SHOPIFY_ACCESS_TOKEN": "<你的訪問令牌>",
                "MYSHOPIFY_DOMAIN": "<your-store>.myshopify.com"
            }
        }
    }
}

3. 啟動服務器並開始使用相關工具。

📚 詳細文檔

工具列表

以下是服務器提供的主要工具：

商品管理

1. get-products：獲取指定條件下的商品信息。
2. create-product：創建新的商品。
3. update-product：更新現有商品的詳細信息。
4. delete-product：刪除指定商品。

客戶管理

5. get-customers：列出所有客戶信息。
6. create-customer：添加新客戶。
7. update-customer：修改客戶資料。
8. delete-customer：移除指定客戶。

訂單處理

9. get-orders：獲取訂單列表。
10. create-order：生成新的訂單。
11. update-order：更新訂單狀態或信息。
12. cancel-order：取消未完成的訂單。

其他功能

13. get-collections：獲取商品集合信息。
14. manage-webhook：訂閱、查找或取消 webhook 事件。
15. get-shop：獲取商店的基本信息。
16. get-shop-details：獲取商店的詳細配置，包括可用配送國家等。

📄 許可證

本項目採用 MIT 許可證，詳情請見 LICENSE 文件。

🔗 社區與支持

• GitHub 倉庫：https://github.com/your-username/shopify-mcp-server
• 問題反饋：歡迎在 Issues 中提交 bug 或提出功能需求。
• 文檔貢獻：歡迎為項目文檔貢獻力量。

相關鏈接

• Shopify 開發文檔
• Model Context Protocol (MCP)