Rezapex Shopify MCP Server Main

🚀 Shopify MCP 服務器

Shopify MCP 服務器是一款強大的工具，可藉助 GraphQL API 與 Shopify 商店的數據進行交互。它提供了豐富的功能，能有效管理產品、客戶和訂單等信息，還具備完善的錯誤處理機制。

✨ 主要特性

• 產品管理：支持創建、更新和刪除產品，方便對商品信息進行維護。
• 客戶管理：可對客戶信息進行有效管理，提升客戶服務質量。
• 訂單處理：能夠處理和跟蹤訂單，確保訂單流程的順暢。
• GraphQL 請求：藉助 GraphQL 客戶端訪問 Shopify API，靈活獲取所需數據。
• 錯誤處理：擁有全面的錯誤處理機制，保障系統的穩定性。

📦 安裝指南

獲取 Shopify 訪問令牌

為了使用此 MCP 服務器，您需要創建一個自定義應用並獲取訪問令牌：

1. 登錄您的 Shopify 管理界面。
2. 進入 Settings > Apps and sales channels。
3. 點擊 Develop apps（可能需要啟用開發者預覽）。
4. 點擊 Create an app，設置應用名稱（例如："Shopify MCP Server"）。
5. 配置 Admin API 作用域，選擇以下範圍：
   • read_products, write_products
   • read_customers, write_customers
   • read_orders, write_orders
6. 安裝應用並獲取訪問令牌。

在 Claude Desktop 上使用

將以下內容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": ["-y", "shopify-mcp-server"],
      "env": {
        "SHOPIFY_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>",
        "MYSHOPIFY_DOMAIN": "<YOUR_SHOP>.myshopify.com"
      }
    }
  }
}

💻 使用示例

基礎用法

1. 獲取產品

get-products [--searchTitle <SEARCH_TITLE>] [--limit <LIMIT>]

此命令用於獲取 Shopify 商店中的產品。可以使用可選參數 --searchTitle 搜索特定標題的產品，並使用 --limit 設置返回的最大數量。

get-products --searchTitle "apple" --limit 10

2. 創建產品

create-product <PRODUCT_NAME> <DESCRIPTION> <PRICE>

此命令用於創建一個新的 Shopify 產品，需要提供產品的名稱、描述和價格。

create-product "New iPhone" "Latest model with advanced features." 999.99

3. 更新產品

update-product <PRODUCT_ID> [--setTitle <NEW_TITLE>] [--setDescription <NEW_DESCRIPTION>] [--setPrice <NEW_PRICE>]

此命令用於更新指定 ID 的產品。可以使用可選參數 --setTitle、--setDescription 和 --setPrice 更新產品的標題、描述和價格。

update-product 123 --setTitle "Updated iPhone" --setDescription "Enhanced features released." --setPrice 1099.99

4. 刪除產品

delete-product <PRODUCT_ID>

此命令用於刪除指定 ID 的產品。

delete-product 123

📚 詳細文檔

開發信息

1. 克隆倉庫：

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

2. 安裝依賴項：

npm install

3. 創建 .env 文件：

SHOPIFY_ACCESS_TOKEN=your_access_token
MYSHOPIFY_DOMAIN=your-store.myshopify.com

4. 構建項目：

npm run build

5. 運行測試：

npm test

依賴項

• @modelcontextprotocol/sdk - MCP 協議實現
• graphql-request - Shopify API 的 GraphQL 客戶端
• zod - 運行時類型驗證

貢獻指南

歡迎貢獻！請先閱讀我們的 Contributing Guidelines。

社區資源

• MCP GitHub Discussions
• 報告問題

📄 許可證

MIT

此文檔詳細介紹了 Shopify MCP 服務器的功能、工具及其使用方法。