BelVG MCP扩展用于PrestaShop🚀
BelVG MCP扩展 将您的PrestaShop存储从被动数据源转换为智能代理系统。
通过扩大官方 PrestaShop MCP服务器，此模块添加了高级业务逻辑工具，允许AI代理（如ChatGPT、Claude或Gemini）使用单个命令执行复杂的管理任务，例如生成每日简报或扫描低库存。
🌟 特性
此模块注入以下内容 AI工具 进入您的MCP服务器：
1.📊 get_morning_briefing
- 它的作用： 生成特定时期内商店业绩的全面执行摘要。
- 为什么使用它： 非常适合通过电子邮件或聊天自动生成每日报告。
- 数据点：
- 总收入（含税） - 订单总数 - 平均购物车价值 - 畅销产品（已售出数量）
- 参数：
- startDate（可选，YYYY-MM-DD，默认为 *昨天*) - endDate（可选，YYYY-MM-DD，默认为 *今天*)
2.📉 get_low_stock_alerts
- 它的作用： 主动扫描您的库存，找出低于特定阈值的产品。
- 为什么使用它： 使AI代理能够自动为供应商起草再订购清单。
- 参数：
- 阈值（可选，默认值：10） - 限制（可选，默认：20项）
📦 安装
先决条件
- PrestaShop：8.0.0或更高
- PHP：8.1或更高
- 所需模块：ps_mcp_server（必须安装并激活官方PrestaShop mcp服务器）。
手动安装
- 下载最新版本或克隆此存储库。
- 将文件夹重命名为belvg_mcp_extended（如果还没有）。
- 将文件夹上传到您的PrestaShop/modules/目录。
- 去你的 后台>模块>模块管理器.
- 搜索 “BelVG MCP扩展” 然后单击 安装.
⚙️ 配置和使用
此模块没有配置页面。它在后台默默工作，将其工具暴露给主MCP服务器。
⚠️ 重要提示：刷新缓存
安装此模块后，您 必须 清除MCP服务器的工具缓存，以便AI“查看”新工具。
- 通过FTP或SSH连接到您的服务器。
- 导航到：/modules/ps_mcp_server/.mcp/
- 删除 cache.json文件。
- 下次连接AI代理时，它将重新扫描系统并发现get_morning_briefing和get_low-stock_alerts。
示例提示
安装后，您可以向AI代理发出如下指令：
*“给我一份关于昨天销售的晨间简报。”*
*检查是否有任何产品的库存少于5件。如果是，请列出它们*
🧑💻 对于开发者
本模块是一个干净的例子，说明如何使用以下工具扩展PrestaShop MCP生态系统 PHP属性.
- 命名空间： BelVG\\模块\\Mcp扩展\\
- 工具定义： 位于src/Tools/StoreManagementTools.php。
- 机制： 该模块实现了isMcpCompaniet（）方法，返回true，该方法向ps_mcp_server发出信号，要求扫描其类中的#\[McpTool\]属性。
添加更多工具
您可以通过编辑src/tools/StoreManagementTools.php轻松添加更多工具：
#\[McpTool（名称：“my_new_tool”，描述：“AI描述”）\]\ 公共函数myNewTool（$arg1）{\ // ...逻辑。..\ }
🤝 贡献
我们欢迎捐款！如果您有更多“代理”工具的想法（例如，检查废弃的购物车、生成代金券代码），请打开Pull Request。
📄 许可证
该模块在\[ALTI-3.0\]\[AFL-3.0\]下发布