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 访问

使用方法（示例 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": "这是更新后的描述。"
    }
  },
  "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 集成需要在此处实现。)