PrestaShop AI管理扩展

BelVG MCP扩展模块将PrestaShop商店转变为智能代理系统,提供自动生成每日简报和库存预警等高级业务逻辑工具。

  • by belvg-public
  • PHP
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 belvg-public/belvg_mcp_extended

使用说明

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服务器)。

手动安装

  1. 下载最新版本或克隆此存储库。
  2. 将文件夹重命名为belvg_mcp_extended(如果还没有)。
  3. 将文件夹上传到您的PrestaShop/modules/目录。
  4. 去你的 后台>模块>模块管理器.
  5. 搜索 “BelVG MCP扩展” 然后单击 安装.

⚙️ 配置和使用

此模块没有配置页面。它在后台默默工作,将其工具暴露给主MCP服务器。

⚠️ 重要提示:刷新缓存

安装此模块后,您 必须 清除MCP服务器的工具缓存,以便AI“查看”新工具。

  1. 通过FTP或SSH连接到您的服务器。
  2. 导航到:/modules/ps_mcp_server/.mcp/
  3. 删除 cache.json文件。
  4. 下次连接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]下发布