shopops-mcp

ShopOps MCP

Shopify および WooCommerce ストアを管理するための Model Context Protocol（MCP）を実装した、AI 搭載サーバーです。

---

特長

• Shopify および WooCommerce 用のストアコネクター。
• 在庫、価格、顧客、注文、商品パフォーマンス、レポートを網羅する12 個の MCP ツール。
• ストアの概要、在庫、最近の注文、上位顧客を提供する4 個の MCP リソース。
• 移動平均による需要予測と安全在庫の計算を使用した在庫予測。
• RFM に基づく顧客セグメンテーション（7 つの異なるセグメント）。
• 利益率に基づく最適化の提案を含む、データ主導の価格分析。
• 注文の異常／不正検知。
• 商品パフォーマンスの ABC 分析。
• 日次および週次レポートの自動生成。
• 2 種類のトランスポート：ローカル stdio と Streamable HTTP（MCPize）。
• TypeScript、@modelcontextprotocol/sdk v1.29 以降、Zod v4。
• 無料プランに加え、€29 の Pro 永続ライセンス。

---

クイックスタート

# 1. Install the package
npm i shopops-mcp

# 2. Create a .env file (see Configuration section)
cp .env.example .env

# 3. Run the server (local stdio mode)
npx shopops-mcp run --transport stdio

# 4. Or start the HTTP endpoint (MCPize deployment)
npx shopops-mcp run --transport http --port 8080

サーバーは環境変数を読み取り、設定されたストアに接続して、MCP ツールとリソースを公開します。

---

MCP ツール

ツール	説明
store_connect	Shopify／WooCommerce ストアへの接続、一覧表示、切断、同期（action: "connect" | "list" | "disconnect" | "sync"）を行い、認証情報を検証します。
store_demo_seed	実際のストアの認証情報がなくてもすべてのツールを試せるよう、リアルなデモストア（商品 20 点、顧客 40 人、注文 150 件以上）を作成します。
inventory_status	現在の在庫数、バックオーダーのフラグ、在庫僅少アラートを返します。
inventory_forecast	移動平均による需要予測と安全在庫バッファーを使用して、将来必要となる在庫数を予測します。
pricing_analyze	価格弾力性レポートを作成し、価格が低すぎる／高すぎる SKU を特定します。
pricing_optimize	利益率分析、販売速度、設定可能な価格ルールに基づいて、最適な価格を提案します。
customers_segment	RFM 分析を実施し、顧客を 7 つのセグメントのいずれかに分類します。
customers_churn	顧客の離反リスクをスコア化し、顧客維持策を提案します。
order_anomalies	パターン認識モデルを使用して、不正または誤りの可能性がある注文を検知します。
product_performance	ABC 分析を実施し、商品クラスごとの貢献指標を返します。
report_daily	日次の運用サマリー（売上、在庫、アラート）を JSON／CSV 形式で作成します。
report_weekly	トレンドの可視化を含む週次パフォーマンスレポートを作成します。

---

MCP リソース

リソース	説明
store://overview	ストアの概要指標：接続済みストアごとの商品数、注文数、顧客数。
store://inventory	在庫僅少アラート：手持ち数量が 10 以下の商品を、数量の少ない順に表示します。
store://orders/recent	すべてのストアの最新注文 20 件を、注文番号、合計金額、ステータス、日付とともに表示します。
store://customers/top	合計購入金額の上位 20 人の顧客を、名前、メールアドレス、注文数とともに表示します。

---

設定

ShopOps が読み取る環境変数はごくわずかです。ストアの認証情報は環境変数ではありません。実行時に store_connect ツールへ渡すため（ストアごとに接続します）、同じサーバープロセスで複数の Shopify／WooCommerce ストアを管理できます。

変数	必須	説明
PORT	いいえ	設定されている場合（または MCPIZE=true の場合）、サーバーはローカルの stdio の代わりに、このポート（デフォルトは 8080）で Streamable HTTP エンドポイントとして動作します。
MCPIZE	いいえ	MCPize ランタイムによって true に設定され、HTTP トランスポートが強制されます。
LEMONSQUEEZY_LICENSE_KEY	いいえ	Pro ライセンスキーです。設定されていない場合、サーバーは Free ティアで動作します（Pro ライセンスを参照）。

最小限の .env が .env.example に用意されています。

ストアの接続

Shopify および WooCommerce の認証情報は、次の例のように store_connect のパラメーターとして渡します。

// Shopify
{ "action": "connect", "platform": "shopify",
  "store_domain": "myshop.myshopify.com", "access_token": "shpat_..." }

// WooCommerce
{ "action": "connect", "platform": "woocommerce",
  "store_url": "https://example.com", "consumer_key": "ck_...", "consumer_secret": "cs_..." }

store_connect は、ほかのすべてのツールが入力として使用する store_id を返します。実際の認証情報を使わずにサーバーを試すには、代わりに store_demo_seed を呼び出してください。

ロードマップ（未実装）： レポートの匿名化、S3 へのレポートのエクスポート、設定可能な料金モデル／ログレベルが計画されていますが、現在のリリースでは読み取られません。

---

Pro ライセンス

ShopOps はFree モードで提供されます。store_demo_seed、store_connect、inventory_status、pricing_analyze、customers_segment、product_performance、report_daily はオープンです。次のツールを使用するには、Pro ライセンスが必要です。

• inventory_forecast — 移動平均による需要予測と再発注ポイント
• pricing_optimize — 実行可能な価格変更の推奨
• customers_churn — 解約リスクのスコアリングと顧客維持の推奨
• order_anomalies — 不正／異常の検出
• report_weekly — 週ごとの傾向レポートと AI インサイト

Pro ライセンスを購入（€29、生涯有効、3 台）： https://automatiabcn.lemonsqueezy.com/buy/cbbe44f0-a146-4c65-88c8-71f371037758

または、Indie MCP Stack Bundle（€69、全 4 サーバー）を入手してください。

export LEMONSQUEEZY_LICENSE_KEY=YOUR-KEY-HERE

または、MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "shopops-mcp": {
      "command": "npx",
      "args": ["-y", "shopops-mcp-server"],
      "env": { "LEMONSQUEEZY_LICENSE_KEY": "YOUR-KEY-HERE" }
    }
  }
}

検証結果はローカルに 24 時間キャッシュされるため、初回実行後は完全にオフラインで使用できます。

---

ライセンス

ShopOps MCP は MIT License のもとで公開されています。全文は LICENSE をご覧ください。

---

作者：Automatia BCN