cscart

This MCP server provides a comprehensive toolset for managing CS-Cart stores, including products, orders, categories, users, and sales analytics. It exposes a range of tools under the Product, Order, Category, User, and Analytics namespaces that you can call through MCP clients. Typical usage involves querying product catalogs, creating and updating products, managing stock, retrieving orders, updating statuses, and pulling sales statistics to inform business decisions. To integrate, configure your MCP client to point at this server and supply the CS-Cart API credentials via environment variables or client configuration. You can invoke actions such as get_products, create_product, update_product, get_orders, update_order_status, get_categories, get_users, and get_sales_statistics to interact with your store programmatically.

Prerequisites:

• Node.js (LTS) and npm installed on your system
• Access/credentials for your CS-Cart API
• Git (optional, for cloning the repo)

Option 1: Quick Setup (Recommended)

1. Clone the repository and navigate into it: git clone <repository-url> cd cscart-mcp-server
2. Run the setup script (if provided): npm run setup
3. Install dependencies: npm install
4. Create and populate the environment file with your CS-Cart credentials (example: .env): CSCART_API_URL=https://your-store.com/api CSCART_API_EMAIL=admin@yourstore.com CSCART_API_KEY=your-api-key-here
5. Start the server: npm start

Option 2: Manual Local Installation

1. Clone the repository and navigate into it: git clone <repository-url> cd cscart-mcp-server
2. Install dependencies: npm install
3. Configure environment variables: cp .env.example .env Edit .env with your CS-Cart API credentials: CSCART_API_URL=https://your-store.com/api CSCART_API_EMAIL=admin@yourstore.com CSCART_API_KEY=your-api-key-here
4. Start the server: npm start

Option 3: Docker Installation

1. Clone the repository and navigate into it: git clone <repository-url> cd cscart-mcp-server
2. Configure environment variables: cp .env.example .env
3. Build and run with Docker Compose: docker-compose up -d Or build and run with Docker: docker build -t cscart-mcp-server . docker run -d --name cscart-mcp-server --env-file .env cscart-mcp-server

Environment variables are used to connect to CS-Cart: CSCART_API_URL (store API endpoint), CSCART_API_EMAIL (admin email), and CSCART_API_KEY (API key). Ensure the API key has the necessary permissions: Products (read/write), Orders (read/write), Categories (read), Users (read), and Statistics (read). If you run into connection errors, verify API URL formatting, credentials, and network access from the MCP host. When using Docker, you can supply an .env file or environment variables in a docker-compose.yml. For production deployments, consider using the production Dockerfile and setting restart policies and resource limits as appropriate.