WooCommerce MCP Server (HTTP/Express)

by Vostos007

132 downloads
Not rated
GitHub

About

MCP сервер для управления магазином WooCommerce

Details

Author
Vostos007
Downloads
132
Categories
Developer Tools

- JSON‑RPC 2.0 protocol over HTTP
- Pre‑defined methods: get_products, get_product, update_product
- API‑key authentication via X‑API‑Key header
- Configurable port and WooCommerce credentials via .env
- Lightweight Express‑based server

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name WooCommerce MCP Server (HTTP/Express)
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository, run npm install, create a .env file with your WooCommerce site URL, consumer key, consumer secret, a chosen port, and an API key for authentication. Start the server with node server.js; the RPC endpoint will be available at http://localhost:3000/rpc. Use POST requests with a JSON-RPC 2.0 body and the X-API-Key header to call methods like get_products, get_product, and update_product.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "woocommerce mcp server (http/express)": {
            "woocommerce-mcp-server-project": {
                "command": "node",
                "args": [
                    "server.js"
                ]
            }
        }
    }
}

McpServers

{
    "woocommerce-mcp-server-project": {
        "command": "node",
        "args": [
            "server.js"
        ]
    }
}

WooCommerce MCP Server (HTTP/Express)

This server provides a JSON-RPC 2.0 interface over HTTP to interact with WooCommerce.

Setup

1. Clone the repository (if not already done).
2. Navigate to the directory:

    cd woocommerce-mcp-server-http

3. Install dependencies:
    npm install

4. Create .env file: Create a file named .env in this directory and add the following variables, replacing placeholder values with your actual credentials:
    # URL вашего WooCommerce
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 сервера (default: 3000)
PORT=3000

# Секретный API-ключ для доступа к этому MCP-серверу
MCP_API_KEY=your_secret_api_key_here

Running the Server

node server.js

The server will start, and you should see:

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

Usage (Example curl Commands)

Replace your_secret_api_key_here with the value you set for MCP_API_KEY in your .env file.

1. Get Products (first 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. Get Specific Product (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. Update Product Description (using payload-http.json):

First, ensure payload-http.json exists with content like:

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

Then run:

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

(Note: Currently, the server uses a placeholder function handleWooCommerceRequest. Actual WooCommerce integration needs to be implemented there.)

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.