Woocommerce MCP Server Project

🚀 WooCommerce MCP 服務器（HTTP/Express）

此服務器藉助 HTTP 提供 JSON - RPC 2.0 接口，用於與 WooCommerce 進行交互，為開發者提供便捷的方式來管理和操作 WooCommerce 相關業務。

🚀 快速開始

安裝指南

克隆倉庫

若你還未克隆該倉庫，請先進行克隆操作。

進入項目目錄

cd woocommerce-mcp-server-http

安裝依賴項

npm install

創建 .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 實際值。

獲取產品（前 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}'

獲取特定產品（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}'

高級用法

更新產品描述（使用 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 集成需要在此處實現。