Woocommerce MCP Server Project

🚀 WooCommerce MCP サーバー（HTTP/Express）

このサーバーは、HTTP を介して JSON-RPC 2.0 インターフェースを提供し、WooCommerce とのやり取りを可能にします。

🚀 クイックスタート

📦 インストール

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）サーバーが http://localhost:3000 で起動しました
   RPC エンドポイントは http://localhost:3000/rpc を通じてアクセスできます

💻 使用例

your_secret_api_key_here を .env ファイルで設定した MCP_API_KEY の実際の値に置き換えてください。

基本的な使用法

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": "これは更新後の説明です。"
    }
  },
  "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 統合はここで実装する必要があります。