PrestaShop MCP服务器
🚀 快速、本地、离线的第一台MCP服务器 用于PrestaShop文档 1095+个索引文档 包括钩子、导轨、组件和API。
一个专业 模型上下文协议（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文档
| 功能 | 官方文档网站 | 此（PrestaShop MCP） |
|---|---|---|
| 访问 | 仅限在线 | 本地+离线 |
| 速度 | 网络依赖 | **瞬时（\功能>MCP服务器）： |
{
"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;"📖 运作原理
- 索引：首次运行时，使用FTS5将1095+文档文件索引到SQLite中
- 挂钩、指南、教程、API文档、组件等 - 自动分类和元数据提取 - CQRS域引用和UI组件检测
- 存储：文件存储在
~/.mcp/prestashop-docs/database.db - 搜索：使用SQLite FTS5进行高效的全文搜索和排名
- 波特堵塞以获得更好的搜索结果 - 按文档类型、类别和其他元数据筛选
- 检索：通过路径或名称直接查找以实现即时访问
- 多运输：支持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开发社区