Skip to main content
Glama
maneeshkumarsaraswat

woo-mcp-server

README.md
# WooCommerce MCP Web Dashboard

A full-stack, standalone Model Context Protocol (MCP) server integrated with a real-time web dashboard to manage WooCommerce stores directly from your browser. 

## Features

* **Real-time SSE Communication**: Connects your web frontend to the Node.js backend using Server-Sent Events (SSE).
* **View Products & Orders**: Fetch catalog details, inventory counts, pricing, and recent orders instantly.
* **Update Stock**: Modify product stock quantities dynamically (`manage_stock: true`) with automated error handling.
* **Delete Products**: Permanently delete products by ID using forced parameters via the WooCommerce REST API.
* **Unified Deployment**: Merges the MCP backend and frontend dashboard (`index.html`) into a single executable URL hosted seamlessly on Render.

## Tech Stack

* **Backend**: Node.js, Express.js, TypeScript, Axios, dotenv, CORS, `@modelcontextprotocol/sdk`.
* **Frontend**: HTML5, CSS3, JavaScript (Fetch API & EventSource).
* **API Integration**: WooCommerce REST API v3 (Authenticated via Consumer Key & Secret).
* **Hosting**: Render (Auto-deployment via GitHub).

## Environment Variables

Configure the following variables in your `.env` file or Render Environment settings:

```env
PORT=3000
WOO_URL=[https://your-woocommerce-store.com](https://your-woocommerce-store.com)
WOO_CONSUMER_KEY=ck_****************************************
WOO_CONSUMER_SECRET=cs_****************************************

Local Development & Setup
Clone the repository:

Bash
git clone [https://github.com/your-username/woo-mcp-server.git](https://github.com/your-username/woo-mcp-server.git)
cd woo-mcp-server
Install dependencies:

Bash
npm install
Build and start the server:

Bash
npm run build
npm start
Access the Dashboard:
Open http://localhost:3000 in your browser to interact with the live management panel.