Shopify Python MCP Server

🚀 Shopify Python MCP 服務器

這是一個與Shopify API連接的MCP服務器，藉助該服務器，能夠從Claude Desktop獲取並操作Shopify的商品信息，為商品管理提供便利。

🚀 快速開始

本服務器可實現與Shopify API的連接，讓你在Claude Desktop中獲取和操作Shopify商品信息。使用前需完成相應的設置。

✨ 主要特性

工具

該服務器提供了一系列實用工具，具體如下：

1. list_products：用於獲取商品列表。
   • limit：指定要獲取的商品數量，最大值為250，默認值是50。
2. get_product：可獲取商品的詳細信息。
   • product_id：商品ID，此為必填項。
3. create_product：用於創建新商品。
   • title：商品名稱，必填。
   • body_html：商品描述，採用HTML格式。
   • vendor：供應商名稱。
   • product_type：商品類型。
   • tags：標籤，以逗號分隔。
   • status：狀態，可選擇active（激活）、draft（草稿）或archived（存檔）。
   • variants：變體。
   • options：選項。
   • images：圖片。
4. update_product：用於更新商品信息。
   • product_id：商品ID，必填。
   • title：商品名稱。
   • body_html：商品描述，HTML格式。
   • vendor：供應商名稱。
   • product_type：商品類型。
   • tags：標籤，逗號分隔。
   • status：狀態（active/draft/archived）。
   • variants：變體。
   • options：選項。
   • images：圖片。
5. delete_product：用於刪除商品。
   • product_id：商品ID，必填。

📦 安裝指南

必要的環境變量

使用該服務器前，需要設置以下環境變量：

• SHOPIFY_SHOP_URL：Shopify商店的URL，例如mystore.myshopify.com。
• SHOPIFY_API_KEY：Shopify Admin API的API密鑰。
• SHOPIFY_API_PASSWORD：Shopify Admin API的API密碼（Secret）。
• SHOPIFY_API_VERSION：Shopify API版本，默認值為2023 - 10。

Claude Desktop設置

在Claude Desktop中使用時，需要進行如下配置：

{
  "env": {
    "SHOPIFY_SHOP_URL": "myshop.myshopify.com",
    "SHOPIFY_API_KEY": "your_api_key",
    "SHOPIFY_API_PASSWORD": "your_api_password"
  }
}

💻 使用示例

基礎用法

獲取商品列表

list_products --limit=10

刪除指定ID的商品

delete_product --product_id=abc123

📚 詳細文檔

開發

安裝依賴

使用以下命令同步並安裝依賴項：

uv sync

調試

使用MCP Inspector進行調試：

npx @modelcontextprotocol/inspector uv --directory /your_path/shopify-py run shopify-py

構建與發佈

準備分發包的步驟如下：

1. 同步依賴並更新鎖定文件：

   uv sync
   

2. 構建包：

   uv build
   

3. 發佈到PyPI：

   uv publish
   

⚠️ 重要提示：發佈到PyPI需要設置認證信息，可以通過環境變量或命令行參數指定。