PrestaShop MCP Server

PrestaShop MCP服务器

🚀 快速、本地、离线的第一台MCP服务器 用于PrestaShop文档 1095+个索引文档 包括钩子、导轨、组件和API。

   ](https://www.docker.com/)

一个专业 模型上下文协议（MCP） 服务器，为Claude、Cursor和其他MCP兼容工具等AI助手提供对全面的PrestaShop开发文档的即时访问。

🎯 为什么选择MCP服务器？

PrestaShop是一个全面的电子商务平台，拥有647多个钩子、复杂的组件架构和广泛的API。此MCP服务器提供即时离线访问 1095+个索引文档:

• 647+PrestaShop挂钩 -所有带有完整元数据的显示和操作挂钩
• 模块开发 -创建和测试模块的完整指南
• 组件体系结构 -表单、网格、服务、CQRS模式（119个组件）
• 主题开发 -模板系统、Smarty/Twig文档
• API 文档 -管理API、Web服务和域引用（96个API）
• 指南和教程 -安装、部署、贡献指南

vs.官方PrestaShop文档

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

🛠️ 可用的MCP工具

配置后，您的AI助手可以访问7个专用工具：

文档工具

1. search_prestashop_docs(query, doc_type, category)

使用全文搜索搜索所有PrestaShop文档。

参数：

• query -搜索词
• doc_type -筛选条件：钩子、指南、教程、api、组件等。
• category -筛选条件：基础知识、开发、模块、主题等。

例子：

"Search PrestaShop docs for module development"
"Find installation guides for Mac"

2. get_prestashop_doc(path)

获取特定文档文件的完整内容。

例子：

"Get the Mac installation guide"

3. list_prestashop_docs(doc_type, category)

列出带有可选过滤器的可用文档文件。

例子：

"List all PrestaShop guides"
"Show me all tutorial documents"

4. get_prestashop_stats()

获取有关索引文档的统计信息。

例子：

"Show me PrestaShop documentation statistics"

挂钩工具

5. search_prestashop_hooks(queries, hook_type, origin)

专门搜索PrestaShop挂钩。

例子：

"Find all hooks related to products"

6. get_prestashop_hook(hook_name)

获取特定钩子的完整文档。

例子：

"Show me the displayHeader hook"

7. list_prestashop_hooks(hook_type, origin)

按类型和来源列出所有钩子。

例子：

"List all display hooks"

💬 查询示例

试着问你的人工智能助手：

安装和设置：

• “如何在Mac上本地安装PrestaShop？”
• “PrestaShop的系统要求是什么？”
• “给我看Docker安装指南”

模块开发：

• “如何创建PrestaShop模块？”
• “搜索模块开发教程”
• “PrestaShop中的模块结构是什么？”

主题开发：

• “如何开发PrestaShop主题？”
• “显示Twig模板文档”
• “查找主题开发指南”

挂钩：

• “显示displayHeader挂钩的文档”
• “查找与产品相关的所有挂钩”
• “列出所有显示挂钩”
• “actionProductAdd钩子是如何工作的？”

组件和架构：

• “PrestaShop中提供了哪些UI组件？”
• “显示表单类型文档”
• “解释PrestaShop中的CQRS模式”

API：

• “如何使用PrestaShop管理员API？”
• “显示Web服务文档”
• “查找API终结点引用”

概述：

• “显示PrestaShop文档统计信息”
• “列出所有可用指南”
• “搜索部署文档”

📊 文件覆盖范围

总计：1095+索引文件

按文档类型

• 647钩子 -所有带有元数据的PrestaShop挂钩

- 显示挂钩（渲染内容） - 动作挂钩（触发功能） - 核心、模块和主题挂钩 - 后台和前台位置

• 138一般文件 -指南、教程、贡献文档
• 119组件 -表单、网格、服务、UI组件
• 96 API参考文献 -管理员API、Web服务、域引用
• 64参考文献 -技术参考和规范
• 12指南 -安装、部署、开发指南
• 10常见问题 -常见问题解答
• 9教程 -分步教程

按类别

• 697模块文档 -模块开发和挂钩
• 208开发文档 -组件、架构、模式
• 88个Web服务文档 -API和Web服务参考资料
• 29主题文档 -主题开发和模板
• 22份贡献文件 -为PrestaShop做出贡献
• 17基础知识 -安装、系统要求、部署
• 还有更多。..

专业数据

• 386域引用 -CQRS命令和查询
• 119 UI组件 -表格类型、网格列等。

🔧 发展

运行测试

# Run all tests
pytest

# Run specific test
pytest tests/test_ingest.py

# Run with coverage
pytest --cov=prestashop_mcp

手动测试

# 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;"

📖 运作原理

1. 索引：首次运行时，使用FTS5将1095+文档文件索引到SQLite中

- 挂钩、指南、教程、API文档、组件等 - 自动分类和元数据提取 - CQRS域引用和UI组件检测

1. 存储：文件存储在 ~/.mcp/prestashop-docs/database.db
2. 搜索：使用SQLite FTS5进行高效的全文搜索和排名

- 波特堵塞以获得更好的搜索结果 - 按文档类型、类别和其他元数据筛选

1. 检索：通过路径或名称直接查找以实现即时访问
2. 多运输：支持STDIO（本地）、HTTP和SSE（远程）协议

🤝 贡献

欢迎投稿！请阅读我们的 贡献指南.

快速开始

# 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

📜 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

🙏 致谢

• 灵感来自 Shopify液体MCP
• 内置于 FastMCP
• 文档来源 PrestaShop文档
• MCP协议 Anthropic

🔗 相关项目

• Shopify液体MCP -用于Shopify主题开发
• Magento GraphQL文档MCP -用于Magento开发
• FastMCP -MCP服务器框架
• 模型上下文协议 -MCP规范

📞 支持

• 🐛 问题
• 💬 讨论

______________________________________________________________________

由...制作❤️ PrestaShop开发社区