woocommerce-mcp

woocommerce-mcp

WordPress + WooCommerce 向けの、小規模な読み取り専用 Model Context Protocol サーバーです。Claude（または任意の MCP クライアント）が、公式 REST API を介して稼働中のストアの商品、注文、売上、ブログ記事について質問できるようにします。書き込みは行わず、ストアへのプラグインのインストールも不要です。既存の WordPress/WooCommerce REST エンドポイントに接続します。

WPPoland が開発・保守しています。WPPoland は、2006 年から WordPress に携わるシニア WordPress 開発者です。実際のストア環境への組み込みが必要な場合は、WooCommerce ERP と API の統合や、エンタープライズ向け e コマースアーキテクチャ（ヘッドレス、統合、AI 対応データ）を構築します。

ツール

ツール	内容	WooCommerce キーが必要
list_products	商品の一覧表示／検索（名前、sku、価格、在庫、パーマリンク）	はい
get_product	ID を指定して 1 つの商品詳細を取得	はい
list_orders	新しい順の最近の注文。ステータスによる絞り込みも可能	はい
sales_report	期間（week / month / last_month / year）の売上合計	はい
search_posts	公開済みブログ記事を検索（公開 WordPress REST API）	いいえ

すべて読み取り専用です。このサーバーがストア内のデータを作成、編集、削除することはありません。

インストールとビルド

npm からインストールする場合（パッケージ名はスコープ付きです。スコープなしの woocommerce-mcp という名前はレジストリで使用できません）：

npm install -g @wppoland/woocommerce-mcp
# or: npx @wppoland/woocommerce-mcp

ソースからインストールする場合：

git clone https://github.com/wppoland/woocommerce-mcp.git
cd woocommerce-mcp
npm install
npm run build

設定

次の環境変数を 3 つ設定します。

変数	必須	例
WP_URL	はい	https://shop.example.com
WC_CONSUMER_KEY	wc_* ツールで必要	ck_xxx
WC_CONSUMER_SECRET	wc_* ツールで必要	cs_xxx

WooCommerce → 設定 → 高度な設定 → REST API → キーを追加から、Read 権限を付与した WooCommerce キーを作成します。search_posts は、公開 WordPress サイトであればキーなしで利用できます。

キーは REST クエリ認証として、HTTPS 経由でお使いのストアに送信されます。HTTPS を使用し、キーには Read アクセス権のみを付与してください。

Claude Desktop / Claude Code での使用

MCP クライアントの設定（例：claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "woocommerce": {
      "command": "node",
      "args": ["/absolute/path/to/woocommerce-mcp/dist/index.js"],
      "env": {
        "WP_URL": "https://shop.example.com",
        "WC_CONSUMER_KEY": "ck_xxx",
        "WC_CONSUMER_SECRET": "cs_xxx"
      }
    }
  }
}

その後、「先月の WooCommerce の売上はいくらでしたか？」や「保留中の最新の注文を 5 件表示して」といった質問をしてみてください。

wppoland.com のドキュメント

• WooCommerce MCP オープンソース（読み取り専用）：リリースと運用ガイド - npm のスコープ、レジストリ、Glama、および書き込みツールなしで更新を配信する方法

記事（外部サイト）

DEV で公開されたフィールドノート（wppoland.com のページと重複するものではありません）：

• WooCommerce 向け読み取り専用 MCP サーバー：AI エージェントがストアに実際に求めるもの
• 過剰販売やサーバーへの過負荷を起こさず、卸売業者の API を WooCommerce に同期する
• wppoland.com を WordPress から Cloudflare Pages 上の Astro に移行して 12 か月後

Show HN：ディスカッション

検証

npm run check   # builds, then asserts all five tools register (no network/credentials needed)

注意事項

• Node 18 以降（組み込みの fetch を使用します）。
• ログは stderr に出力されるため、stdout 上の stdio MCP プロトコルを破損しません。
• API エラーにはストアのメッセージが表示されます。認証情報が出力されることはありません。

ライセンス

MIT © WPPoland