WooCommerce MCP Server (HTTP/Express)

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) server listening at http://localhost:3000
   RPC Endpoint available at http://localhost:3000/rpc

用法（curl 命令示例）

将 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": "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 的实际集成。）