# Prestashop Mcp

> 🚀 **Fast, local, offline-first MCP server** for PrestaShop documentation with **1,095+ indexed documents** including hooks, guides, components, and APIs.

- **Type:** MCP server
- **Install:** `agentstack add mcp-florinel-chis-prestashop-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [florinel-chis](https://agentstack.voostack.com/s/florinel-chis)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [florinel-chis](https://github.com/florinel-chis)
- **Source:** https://github.com/florinel-chis/prestashop-mcp

## Install

```sh
agentstack add mcp-florinel-chis-prestashop-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# PrestaShop MCP Server

> 🚀 **Fast, local, offline-first MCP server** for PrestaShop documentation with **1,095+ indexed documents** including hooks, guides, components, and APIs.

[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
[](https://modelcontextprotocol.io/)
[](https://www.docker.com/)

A specialized [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that provides instant access to comprehensive PrestaShop development documentation for AI assistants like Claude, Cursor, and other MCP-compatible tools.

## 🎯 Why This MCP Server?

PrestaShop is a comprehensive e-commerce platform with 647+ hooks, complex component architecture, and extensive APIs. This MCP server provides instant, offline access to **1,095+ indexed documents**:

- **647+ PrestaShop Hooks** - All display and action hooks with complete metadata
- **Module Development** - Complete guides for creating and testing modules
- **Component Architecture** - Forms, Grids, Services, CQRS patterns (119 components)
- **Theme Development** - Template system, Smarty/Twig documentation
- **API Documentation** - Admin API, webservice, and domain references (96 APIs)
- **Guides & Tutorials** - Installation, deployment, contribution guides

### vs. Official PrestaShop Documentation

| Feature | Official Docs Website | This (PrestaShop MCP) |
|---------|----------------------|----------------------|
| **Access** | Online only | **Local + Offline** |
| **Speed** | Network-dependent | **Instant ( Features > MCP Servers):

```json
{
  "mcpServers": {
    "prestashop": {
      "command": "prestashop-mcp"
    }
  }
}
```

## 🛠️ Available MCP Tools

Once configured, your AI assistant has access to 7 specialized tools:

### Documentation Tools

#### 1. `search_prestashop_docs(query, doc_type, category)`
Search ALL PrestaShop documentation using full-text search.

**Parameters:**
- `query` - Search terms
- `doc_type` - Filter by: hook, guide, tutorial, api, component, etc.
- `category` - Filter by: basics, development, modules, themes, etc.

**Example:**
```
"Search PrestaShop docs for module development"
"Find installation guides for Mac"
```

#### 2. `get_prestashop_doc(path)`
Get the full content of a specific documentation file.

**Example:**
```
"Get the Mac installation guide"
```

#### 3. `list_prestashop_docs(doc_type, category)`
List available documentation files with optional filters.

**Example:**
```
"List all PrestaShop guides"
"Show me all tutorial documents"
```

#### 4. `get_prestashop_stats()`
Get statistics about the indexed documentation.

**Example:**
```
"Show me PrestaShop documentation statistics"
```

### Hook Tools

#### 5. `search_prestashop_hooks(queries, hook_type, origin)`
Search PrestaShop hooks specifically.

**Example:**
```
"Find all hooks related to products"
```

#### 6. `get_prestashop_hook(hook_name)`
Get complete documentation for a specific hook.

**Example:**
```
"Show me the displayHeader hook"
```

#### 7. `list_prestashop_hooks(hook_type, origin)`
List all hooks organized by type and origin.

**Example:**
```
"List all display hooks"
```

## 💬 Example Queries

Try asking your AI assistant:

**Installation & Setup:**
- "How do I install PrestaShop locally on Mac?"
- "What are the system requirements for PrestaShop?"
- "Show me the Docker installation guide"

**Module Development:**
- "How do I create a PrestaShop module?"
- "Search for module development tutorials"
- "What's the module structure in PrestaShop?"

**Theme Development:**
- "How do I develop a PrestaShop theme?"
- "Show me Twig template documentation"
- "Find theme development guides"

**Hooks:**
- "Show me documentation for the displayHeader hook"
- "Find all hooks related to products"
- "List all display hooks"
- "How does the actionProductAdd hook work?"

**Components & Architecture:**
- "What UI components are available in PrestaShop?"
- "Show me form types documentation"
- "Explain the CQRS pattern in PrestaShop"

**APIs:**
- "How do I use the PrestaShop Admin API?"
- "Show me webservice documentation"
- "Find API endpoint references"

**General:**
- "Show me PrestaShop documentation statistics"
- "List all available guides"
- "Search for deployment documentation"

## 📊 Documentation Coverage

**Total: 1,095+ Indexed Documents**

### By Document Type

- **647 Hooks** - All PrestaShop hooks with metadata
  - Display hooks (render content)
  - Action hooks (trigger functionality)
  - Core, Module, and Theme hooks
  - Back office and Front office locations
- **138 General Docs** - Guides, tutorials, contribution docs
- **119 Components** - Forms, Grids, Services, UI components
- **96 API References** - Admin API, webservice, domain references
- **64 References** - Technical references and specifications
- **12 Guides** - Installation, deployment, development guides
- **10 FAQs** - Frequently asked questions
- **9 Tutorials** - Step-by-step tutorials

### By Category

- **697 Module docs** - Module development and hooks
- **208 Development docs** - Components, architecture, patterns
- **88 Webservice docs** - API and webservice references
- **29 Theme docs** - Theme development and templates
- **22 Contribution docs** - Contributing to PrestaShop
- **17 Basics** - Installation, system requirements, deployment
- And more...

### Specialized Data

- **386 Domain References** - CQRS commands and queries
- **119 UI Components** - Form types, grid columns, etc.

## 🔧 Development

### Running Tests

```bash
# Run all tests
pytest

# Run specific test
pytest tests/test_ingest.py

# Run with coverage
pytest --cov=prestashop_mcp
```

### Manual Testing

```bash
# Index documentation (uses new comprehensive indexer)
python -m prestashop_mcp.ingest_v2

# Force reindex
python -m prestashop_mcp.ingest_v2 --force

# Check database
sqlite3 ~/.mcp/prestashop-docs/database.db "SELECT COUNT(*) FROM prestashop_docs;"

# Get statistics by type
sqlite3 ~/.mcp/prestashop-docs/database.db "SELECT doc_type, COUNT(*) FROM prestashop_docs GROUP BY doc_type;"
```

## 📖 How It Works

1. **Indexing**: On first run, indexes 1,095+ documentation files into SQLite with FTS5
   - Hooks, guides, tutorials, API docs, components, and more
   - Automatic categorization and metadata extraction
   - CQRS domain references and UI component detection
2. **Storage**: Documentation stored in `~/.mcp/prestashop-docs/database.db`
3. **Search**: Uses SQLite FTS5 for efficient full-text search with ranking
   - Porter stemming for better search results
   - Filter by document type, category, and other metadata
4. **Retrieval**: Direct lookups by path or name for instant access
5. **Multi-Transport**: Supports STDIO (local), HTTP, and SSE (remote) protocols

## 🤝 Contributing

Contributions welcome! Please read our [Contributing Guide](./CONTRIBUTING.md).

### Quick Start

```bash
# Fork and clone
git clone https://github.com/florinel-chis/prestashop-mcp.git
cd prestashop-mcp

# Create virtual environment
python -m venv venv
source venv/bin/activate  # or `venv\Scripts\activate` on Windows

# Install for development
pip install -e ".[dev]"

# Run tests
pytest

# Format code
black prestashop_mcp/

# Make changes and submit PR
```

## 📜 License

MIT License - see [LICENSE](./LICENSE) file for details.

## 🙏 Acknowledgments

- Inspired by [Shopify Liquid MCP](https://github.com/florinel-chis/shopify-liquid-mcp)
- Docker integration based on best practices from [Magento GraphQL Docs MCP](https://github.com/florinel-chis/magento-graphql-docs-mcp), thank you [@cmuench](https://github.com/cmuench)
- Built with [FastMCP](https://github.com/jlowin/fastmcp)
- Documentation from [PrestaShop Docs](https://github.com/PrestaShop/docs)
- MCP Protocol by [Anthropic](https://www.anthropic.com/)

## 🔗 Related Projects

- [Shopify Liquid MCP](https://github.com/florinel-chis/shopify-liquid-mcp) - For Shopify theme development
- [Magento GraphQL Docs MCP](https://github.com/florinel-chis/magento-graphql-docs-mcp) - For Magento development
- [FastMCP](https://github.com/jlowin/fastmcp) - MCP server framework
- [Model Context Protocol](https://modelcontextprotocol.io/) - MCP specification

## 📞 Support

- 🐛 [Issues](https://github.com/florinel-chis/prestashop-mcp/issues)
- 💬 [Discussions](https://github.com/florinel-chis/prestashop-mcp/discussions)

---

**Made with ❤️ for the PrestaShop development community**

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [florinel-chis](https://github.com/florinel-chis)
- **Source:** [florinel-chis/prestashop-mcp](https://github.com/florinel-chis/prestashop-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-florinel-chis-prestashop-mcp
- Seller: https://agentstack.voostack.com/s/florinel-chis
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.