Shopify Python MCP Server

🚀 Shopify Python MCP サーバー

このサーバーは、Shopify APIに接続するMCPサーバーです。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に公開するには、認証情報を設定する必要があります。環境変数またはコマンドライン引数で指定することができます。