WooCommerce MCP Server (HTTP/Express)

WooCommerce MCP サーバー（HTTP/Express）

このサーバーは、WooCommerce とやり取りするための JSON-RPC 2.0 インターフェースを HTTP 経由で提供します。

セットアップ

1. リポジトリをクローンします（まだの場合）。
2. ディレクトリに移動します：

   cd woocommerce-mcp-server-http
   

3. 依存関係をインストールします：

   npm install
   

4. .env ファイルを作成します： このディレクトリに .env という名前のファイルを作成し、プレースホルダーの値を実際の認証情報に置き換えて、次の変数を追加します：

   # WooCommerce の URL
   WORDPRESS_SITE_URL=https://your-woocommerce-site.com
   
   # WooCommerce API キー
   WOOCOMMERCE_CONSUMER_KEY=ck_your_consumer_key
   WOOCOMMERCE_CONSUMER_SECRET=cs_your_consumer_secret
   
   # MCP サーバーのポート（デフォルト：3000）
   PORT=3000
   
   # この MCP サーバーへのアクセス用のシークレット API キー
   MCP_API_KEY=your_secret_api_key_here 
   

サーバーの起動

node server.js

サーバーが起動すると、次のように表示されます：

✅ MCP HTTP (Express) server listening at http://localhost:3000
   RPC Endpoint available at http://localhost:3000/rpc

使用方法（curl コマンドの例）

.env ファイルで MCP_API_KEY に設定した値に、your_secret_api_key_here を置き換えます。

1. 商品を取得する（最初の 3 件）：

curl -X POST http://localhost:3000/rpc \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_secret_api_key_here" \
  -d '{"jsonrpc":"2.0","method":"get_products","params":{"perPage":3},"id":1}'

2. 特定の商品を取得する（ID：4644）：

curl -X POST http://localhost:3000/rpc \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_secret_api_key_here" \
  -d '{"jsonrpc":"2.0","method":"get_product","params":{"productId":4644},"id":2}'

3. 商品の説明を更新する（payload-http.json を使用）：

まず、次のような内容で payload-http.json が存在することを確認します：

{
  "jsonrpc": "2.0",
  "method": "update_product",
  "params": {
    "productId": 4644,
    "productData": {
      "description": "This is the updated description."
    }
  },
  "id": 3
}

次に、実行します：

curl -X POST http://localhost:3000/rpc \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_secret_api_key_here" \
  -d @payload-http.json

(注：現在、サーバーはプレースホルダー関数 handleWooCommerceRequest を使用しています。実際の WooCommerce との連携は、この関数内に実装する必要があります。)