PrestaShop MCP Server

A professional Model Context Protocol (MCP) Server for complete management of PrestaShop e-commerce stores with extended functionality.

🚀 Overview

This MCP Server enables complete management of your PrestaShop store through AI applications like Claude Desktop. With specialized tools, you can manage all aspects of your e-commerce business - from products and categories to customers, orders, modules, cache, themes, and navigation menus.

✨ Features

• 🛍️ Complete Store Management - Tools for all e-commerce areas
• 🔧 Module Management - Install, activate, deactivate modules
• 💾 Cache Management - Clear and monitor cache status
• 🎨 Theme Management - Configure themes and settings
• 📋 Menu Management - Manage main navigation (ps_mainmenu)
• 🏗️ MCP Protocol Compliance for seamless AI integration
• ⚡ Async/Await Architecture for maximum performance
• 🛡️ Comprehensive Error Handling and validation
• 🔧 Production-Ready with complete test suite
• 📖 Comprehensive Documentation with practical examples

🛠️ Available Tools

📦 Unified Product Management

• `get_products` - UNIFIED Product retrieval supporting all use cases:
  • Single Product by ID: Complete product details including stock and category info
  • Multiple Products: List with optional filtering and enhancement
  • Flexible Enhancement: Optional stock info, category details, custom field selection
  • Smart Filtering: By category, name, or custom criteria
• `create_product` - Create new products with complete configuration
• `update_product` - Edit product information
• `delete_product` - Remove products
• `update_product_stock` - Manage inventory levels
• `update_product_price` - Update pricing

🏷️ Category Management

• `get_categories` - Retrieve categories (with hierarchy filter)
• `create_category` - Create new categories
• `update_category` - Edit categories
• `delete_category` - Remove categories

👥 Customer Management

• `get_customers` - Retrieve and filter customers
• `create_customer` - Create new customers
• `update_customer` - Edit customer data

📋 Order Management

• `get_orders` - Retrieve and filter orders
• `update_order_status` - Change order status
• `get_order_states` - Retrieve available statuses

🔧 Module Management NEW

• `get_modules` - List all PrestaShop modules
• `get_module_by_name` - Get specific module details
• `install_module` - Install new modules
• `update_module_status` - Activate/deactivate modules

📋 Main Menu Management NEW

• `get_main_menu_links` - Retrieve ps_mainmenu navigation links
• `update_main_menu_link` - Edit existing menu links
• `add_main_menu_link` - Add new navigation links

💾 Cache Management NEW

• `clear_cache` - Clear PrestaShop cache (all types)
• `get_cache_status` - Monitor cache configuration

🎨 Theme Management NEW

• `get_themes` - Get current theme information
• `update_theme_setting` - Configure theme settings

⚙️ Store Administration

• `test_connection` - Test API connection
• `get_shop_info` - Comprehensive store statistics

📋 Installation

⚠️ Recommended Installation (Virtual Environment)

This approach prevents module conflicts and ensures reliable installation:

Windows:

# Clone repository
git clone https://github.com/latinogino/prestashop-mcp.git
cd prestashop-mcp

# Create virtual environment
python -m venv venv_prestashop

# Activate virtual environment
.\venv_prestashop\Scripts\Activate.ps1

# Install dependencies
pip install -r requirements.txt

# Install package in development mode
pip install -e .

# Verify installation
python -c "import prestashop_mcp; print('✅ Installation successful')"

# Note the Python path for Claude Desktop configuration
Write-Host "Python Path: $((Get-Command python).Source)"

Linux/macOS:

# Clone repository
git clone https://github.com/latinogino/prestashop-mcp.git
cd prestashop-mcp

# Create virtual environment
python3 -m venv venv_prestashop

# Activate virtual environment
source venv_prestashop/bin/activate

# Install dependencies
pip install -r requirements.txt

# Install package in development mode
pip install -e .

# Verify installation
python -c "import prestashop_mcp; print('✅ Installation successful')"

# Note the Python path for Claude Desktop configuration
which python

⚙️ Configuration

Create a `.env` file based on `.env.example`:

# PrestaShop Configuration
PRESTASHOP_SHOP_URL=https://your-shop.example.com
PRESTASHOP_API_KEY=YOUR_API_KEY

# Logging
LOG_LEVEL=INFO

🎯 Usage

🤖 With Claude Desktop

Using Virtual Environment (Recommended)

Add this configuration to `claude_desktop_config.json`:

Windows:

{
  "mcpServers": {
    "prestashop": {
      "command": "C:\\\\path\\\\to\\\\prestashop-mcp\\\\venv_prestashop\\\\Scripts\\\\python.exe",
      "args": ["-m", "prestashop_mcp.prestashop_mcp_server"],
      "cwd": "C:\\\\path\\\\to\\\\prestashop-mcp",
      "env": {
        "PRESTASHOP_SHOP_URL": "https://your-shop.example.com",
        "PRESTASHOP_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Linux/macOS:

{
  "mcpServers": {
    "prestashop": {
      "command": "/path/to/prestashop-mcp/venv_prestashop/bin/python",
      "args": ["-m", "prestashop_mcp.prestashop_mcp_server"],
      "cwd": "/path/to/prestashop-mcp",
      "env": {
        "PRESTASHOP_SHOP_URL": "https://your-shop.example.com",
        "PRESTASHOP_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

💻 CLI Usage

# Activate virtual environment first (if using venv)
source venv_prestashop/bin/activate  # Linux/macOS
.\venv_prestashop\Scripts\Activate.ps1  # Windows

# With environment variables
prestashop-mcp

# With direct parameters
prestashop-mcp --shop-url https://your-shop.com --api-key YOUR_API_KEY

# Debug mode
prestashop-mcp --log-level DEBUG

🆕 Extended Functionality Examples

Module Management

"Show me all modules in my PrestaShop store"
"Activate the ps_mainmenu module"
"Deactivate the blockcart module"
"Get details for the ps_featuredproducts module"

Main Menu Management

"Show me all main menu links"
"Add a new menu link called 'Special Offers' pointing to /special-offers"
"Update menu link 3 to point to /new-products"
"Make menu link 5 inactive"

Cache Management

"Clear all PrestaShop cache"
"Show me the current cache status"
"Check if CSS cache is enabled"

Theme Management

"Show me current theme settings"
"Update the PS_LOGO setting to /img/new-logo.png"
"Change the PS_THEME_NAME to my-custom-theme"

🆕 Unified Product API

The `get_products` tool handles all product retrieval scenarios with a single, powerful interface:

Use Cases:

🛠️ Advanced Features

ps_mainmenu Integration

The ps_mainmenu module management allows you to:

• Retrieve all main navigation links
• Add custom navigation items
• Update existing menu links (name, URL, status)
• Control menu link positioning

Cache Performance Optimization

Cache management includes:

• Clear all cache types (CSS, JS, Template, General)
• Monitor cache status for performance optimization
• Toggle cache settings for development/production

Module Lifecycle Management

Complete module control:

• List all installed modules with status
• Install new modules programmatically
• Activate/deactivate modules as needed
• Get detailed module information

Theme Customization

Theme management capabilities:

• View current theme configuration
• Update theme-specific settings
• Manage logos and visual elements
• Configure theme-related PrestaShop settings

🔧 Troubleshooting

❌ Common Issues

"ModuleNotFoundError: No module named 'prestashop_mcp'"

Solution: Use virtual environment and ensure package is installed:

# Check if in virtual environment
python -c "import sys; print(sys.prefix)"

# Reinstall package
pip install -e .

# Verify installation
python -c "import prestashop_mcp; print('Module found')"

Module Management Issues

Check Module Permissions:

# Ensure your API key has module management permissions
curl -u "YOUR_API_KEY:" https://your-shop.com/api/modules?output_format=JSON

Cache Clear Not Working

Alternative Cache Clear:

If the API-based cache clear doesn't work, you may need to:

1. Check PrestaShop permissions for API user

2. Use manual cache clearing in PrestaShop admin

3. Verify cache directory write permissions

🔍 Debug Mode

Enable debug logging in Claude Desktop configuration:

{
  "mcpServers": {
    "prestashop": {
      "command": "path/to/python",
      "args": ["-m", "prestashop_mcp.prestashop_mcp_server"],
      "cwd": "path/to/prestashop-mcp",
      "env": {
        "PRESTASHOP_SHOP_URL": "https://your-shop.example.com",
        "PRESTASHOP_API_KEY": "YOUR_API_KEY",
        "LOG_LEVEL": "DEBUG"
      }
    }
  }
}

📊 Project Structure

prestashop-mcp/
├── src/prestashop_mcp/                  # Main Package
│   ├── prestashop_mcp_server.py         # MCP Server (Extended)
│   ├── prestashop_client.py             # PrestaShop API Client (Extended)
│   ├── config.py                        # Configuration Management
│   └── cli.py                          # Command Line Interface
├── tests/                               # All Tests
│   ├── test_config.py                   # Unit Tests
│   └── test_crud_operations.py          # CRUD Integration Tests
├── venv_prestashop/                     # Virtual Environment (after setup)
├── README.md                            # Documentation
├── CHANGELOG.md                         # Version History
├── pyproject.toml                       # Package Configuration
└── requirements.txt                     # All Dependencies

📖 API Documentation

PrestaShop API

Complete PrestaShop API documentation:

• **PrestaShop DevDocs - Webservice**

Authentication

curl -u "API_KEY:" https://your-shop.com/api/configurations?output_format=JSON

Important Endpoints

• Products: `/api/products`
• Categories: `/api/categories`
• Customers: `/api/customers`
• Orders: `/api/orders`
• Stock: `/api/stock_availables`
• Order Status: `/api/order_states`
• Modules: `/api/modules` NEW
• Configurations: `/api/configurations` NEW

🧪 Development

🏗️ Development Environment

# Activate virtual environment
source venv_prestashop/bin/activate  # Linux/macOS
.\venv_prestashop\Scripts\Activate.ps1  # Windows

# All dependencies (including test dependencies) are in requirements.txt
pip install -r requirements.txt

# Run tests
pytest

# Run tests with coverage
pytest --cov=src/prestashop_mcp --cov-report=html

# Run comprehensive integration tests
python tests/test_crud_operations.py

📖 Resources

• **PrestaShop Official Documentation**
• **Model Context Protocol Specification**
• **Claude Desktop MCP Integration**
• **GitHub Repository**

📄 License

MIT License - see LICENSE for details.

📝 Changelog

See CHANGELOG.md for a detailed history of changes.

🏗️ Project Status & Development Notes

📋 Maintenance Status

⚠️ Limited Maintenance: I currently do not plan to actively maintain this repository. The PrestaShop MCP Server was rather a test of how an MCP server can be created without significant own programming experience and largely based on LLMs and MCPs.

🧪 Experimental Nature

This project served as a Proof of Concept for:

• LLM-Assisted Development: Development of complex software integration solutions with minimal manual programming
• MCP Server Architecture: Practical implementation of the Model Context Protocol specification
• AI-Driven E-Commerce Integration: Automated PrestaShop management through natural language
• No-Code/Low-Code Approach: Maximum use of AI tools for professional software development

🐳 Planned Docker Distribution

Upcoming Features:

It is still planned to provide the entire MCP server as a ready-made Docker container as soon as all functions are implemented as desired.

Benefits of Docker deployment:

• ✅ Zero-Configuration Setup: Easy installation without complex Python environment
• ✅ Consistent Environment: Identical behavior on all platforms
• ✅ Isolated Dependencies: No conflicts with local Python installations
• ✅ Production-Ready: Optimized for productive use
• ✅ Auto-Updates: Easy update to new versions

Planned Docker usage:

# Future Docker installation (planned)
docker pull latinogino/prestashop-mcp:latest
docker run -e PRESTASHOP_SHOP_URL=https://your-shop.com \
           -e PRESTASHOP_API_KEY=your-key \
           -p 8080:8080 \
           latinogino/prestashop-mcp:latest

🎯 Manage your complete PrestaShop store including modules, cache, themes, and navigation through natural language with Claude Desktop!