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.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo issues