Shopify MCP

🚀 Shopify MCP 服務器

Shopify MCP 服務器是一個基於 Shopify API 的服務器，藉助 GraphQL API 實現與商店數據的交互。它為用戶提供了管理商品、客戶、訂單等功能的實用工具。如果您覺得這個項目不錯，歡迎點個星支持一下！

🚀 快速開始

要使用此 MCP 服務器，您需要滿足以下先決條件並完成相應的設置：

先決條件

1. Node.js（版本 16 或更高）
2. Shopify 自定義應用訪問令牌（參見下面的設置）

設置

創建自定義應用獲取訪問令牌

要使用此 MCP 服務器，您需要在 Shopify 後臺創建一個自定義應用並獲取訪問令牌。步驟如下：

1. 登錄到您的 Shopify 管理員面板。
2. 導航至 應用程序 > 自定義應用。
3. 點擊 新建應用。
4. 填寫應用信息，包括名稱和回調 URL（例如 http://localhost:8080）。
5. 保存應用後，進入應用詳情頁面獲取 訪問令牌。

將此訪問令牌用於配置 MCP 服務器時需要的憑據。

使用 Claude Desktop 配置

在 Claude Desktop 中使用以下 JSON 配置：

{
  "name": "Shopify MCP Server",
  "type": "process",
  "command": "npx",
  "args": [
    "shopify-mcp-server",
    "--apiKey",
    "<您的 API 密鑰>",
    "--apiSecretKey",
    "<您的 API 秘鑰>",
    "--host",
    "localhost",
    "--port",
    "8080"
  ],
  "stdout": {
    "filePath": "/var/log/claude/shopify-mcp-server.stdout.log",
    "maxSize": 1024,
    "numFiles": 3
  },
  "stderr": {
    "filePath": "/var/log/claude/shopify-mcp-server.stderr.log",
    "maxSize": 1024,
    "numFiles": 3
  }
}

將 <您的 API 密鑰> 和 <您的 API 秘鑰> 替換為您實際的 Shopify 應用憑據。

使用環境變量

您也可以通過設置以下環境變量來配置 MCP 服務器：

• SHOPFY_API_KEY：API 訪問令牌
• SHOPFY_API_SECRET_KEY：API 密鑰
• MCP_HOST：默認為 localhost
• MCP_PORT：默認為 8080

直接安裝

如果需要，您可以直接安裝此服務器：

npm install -g shopify-mcp-server

然後運行它：

shopify-mcp-server --apiKey=<您的 API 密鑰> --apiSecretKey=<您的 API 秘鑰>

✨ 主要特性

• 商品管理：可搜索和獲取商品信息。
• 客戶管理：能加載客戶數據並管理客戶標籤。
• 訂單管理：具備高級查詢和篩選功能。
• GraphQL 集成：直接集成 Shopify 的 GraphQL 管理 API。
• 全面錯誤處理：提供清晰的錯誤消息，針對 API 和身份驗證問題。

💻 使用示例

商品管理

基礎用法

• get-products：獲取商品列表

{
  "status": "active" // 可選：篩選狀態，默認返回所有商品
}

高級用法

• get-product-by-id：通過 ID 獲取單個商品
• update-product：更新商品信息

客戶管理

基礎用法

• get-customers：獲取客戶列表

高級用法

• get-customer-by-id：通過 ID 獲取客戶詳細信息
• create-customer：創建新客戶

{
  "email": "test@example.com",
  "first_name": "John",
  "last_name": "Doe"
}

• update-customer：更新客戶信息
• delete-customer：刪除客戶

訂單管理

基礎用法

• get-orders：獲取訂單列表

高級用法

• get-order-by-id：通過 ID 獲取訂單詳細信息
• create-order：創建新訂單
• update-order：更新訂單信息

📚 詳細文檔

調試

如需調試，請檢查 Claude Desktop 的 MCP 日誌：

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

📄 許可證

本項目採用 MIT 許可證。