Amir Bengherbi Shopify MCP Server

🚀 Shopify MCP 服務器

Shopify MCP 服務器是一個強大的工具，它通過 GraphQL API 與 Shopify 進行數據交互，遵循 MCP 協議提供標準化接口，還能與多種工具集成，為開發者提供便捷的數據處理方案。

🚀 快速開始

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. 啟動服務：

node index.js

✨ 主要特性

• 數據交互：通過 GraphQL API 實現與 Shopify 的數據通信
• 協議支持：遵循 Model Context Protocol (MCP)，提供標準化的數據接口
• 多端兼容：支持 Claude Desktop 和其他 MCP 兼容工具的集成

💻 使用示例

基礎用法

通過命令行調用：

npx shopify-mcp-server --command getProducts --id "123"

高級用法

在實際開發中，你可以根據業務需求，靈活調整 GraphQL 查詢參數，以獲取不同的數據。例如，你可以修改 GetProduct 查詢中的 id 參數，獲取不同產品的信息。

📚 詳細文檔

核心組件

數據模型

interface Product {
  id: string;
  title: string;
  price: number;
  description: string;
  images?: Image[];
}

interface Image {
  url: string;
  altText: string;
}

GraphQL 查詢示例

query GetProduct($id: String!) {
  product(id: $id) {
    id
    title
    price
    description
    images {
      url
      altText
    }
  }
}

技術架構

• 協議層：基於 MCP 協議實現數據通信
• 接口層：提供統一的 GraphQL 接口
• 存儲層：支持本地緩存和遠程數據同步

安全注意事項

1. 嚴格控制訪問令牌權限：

   • 只授予必要的 API 權限
   • 定期輪換令牌

2. 網絡傳輸加密：

   • 使用 HTTPS 通信
   • 配置 SSL 證書

3. 操作日誌記錄：

   • 記錄所有敏感操作
   • 定期審計日誌

常見問題

1. 如何獲取訪問令牌？

步驟：

1. 登錄 Shopify 管理界面
2. 進入應用設置 > API 權限
3. 創建新的訪問令牌

2. 支持哪些 GraphQL 查詢？

支持以下操作：

• 獲取產品信息
• 修改商品庫存
• 管理客戶數據
• 處理訂單狀態

開發文檔

源碼倉庫

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

項目結構

src/
├── server.ts          # 主服務器文件
├── schema.ts         # GraphQL 模式定義
└── resolvers.ts      # 數據解析器

貢獻指南

1. 提交代碼前，請確保通過所有測試用例。
2. 為新功能添加相應的文檔和註釋。
3. 遵循項目編碼規範。

⚠️ 重要提示

本文檔為開發參考，具體實現細節可能因版本更新而有所變化。