🧠 Agente de Reportes — ComaPOS | n8n + MCP Server/Client

🧠 报表 Agent — ComaPOS | n8n + MCP 服务/客户端

此仓库包含一个使用 n8n 开发的智能报表 Agent，专为与销售点系统 ComaPOS 集成而设计。它采用基于 MCP 服务和 MCP 客户端的架构，自动生成、查询并发送关键业务报表。

---

📦 这个 Agent 能做什么？

此助手可对 ComaPOS 后端进行自动查询，以获取以下数据：

• 当日销售额或指定日期范围内的销售额。
• 库存不足的产品。
• 收银交易记录。
• 自定义报表。

随后，它会自动将结果发送到配置的渠道（电子邮件、Telegram 等），无需人工干预；整个过程均由 n8n 工作流协调完成。

---

🔁 工作流架构

系统由三个主要工作流组成，各自承担明确的职责：

1. MCP Server - Reports

负责向 ComaPOS 后端发送 HTTP 请求，以获取所需信息。

• 使用 HTTP Request 节点查询后端受保护或公开的端点（例如：/api/reportes/ventas-del-dia）。
• 可以接收来自其他工作流的动态参数（例如日期或自定义筛选条件）。

2. MCP Server - Mails

负责通过电子邮件发送报表（或通过其他渠道发送）。

• 使用 Gmail、SMTP 或 Webhook 节点与外部平台集成。
• 支持自定义消息和附件（PDF、Excel、JSON）。

3. MCP Client

这是连接两个 MCP 服务的主 Agent：

• 接收来自其他系统的命令或指令（例如：“发送今天的销售报表”）。
• 调用 MCP Server Reports 工作流以获取信息。
• 然后调用 MCP Server Mails，将回复发送给用户。

这种结构让其他 Agent 或工作流能够灵活组合、扩展和复用各个组件。

---

🔌 技术要求

• 正常运行的 n8n 实例（可自托管或使用云端服务）。
• 投入生产环境的 ComaPOS 系统，其 REST API 已开放并可从 n8n 访问。
• 已配置与外部消息服务的连接（例如 Gmail、Outlook、SendGrid 等）。
• 已通过身份验证访问 ComaPOS 后端端点（通常使用令牌或 JWT 凭据）。
• 根据业务逻辑定义 MCP 规则（例如“库存不足”“今日销售”“月度报表”）。

---

⚙️ 使用的技术

• n8n（无代码自动化工作流）
• ComaPOS API（使用 Node.js + MySQL 开发的后端）
• HTTP Request 节点
• Gmail 节点（或任何其他电子邮件发送系统）
• 用于 A2A（Agent to Agent）集成的内部 Webhook

---

✏️ 工作流示例

1. MCP 客户端收到“今日销售报表”的触发指令。
2. 调用 MCP Server Reports 工作流，该工作流向以下地址发送 HTTP Request：
   https://api.comapos.com/api/reportes/ventas-hoy
3. 将响应转换为易读格式（JSON、表格、PDF）。
4. 然后，MCP Server Mails 被触发，并向收件人发送包含报表的电子邮件。

---

📬 联系方式

有疑问、建议或想要参与协作？

Alejandro Osorio
ComaPOS 系统及自动化架构的开发者。
📧 个人邮箱：[email protected]
📧 企业邮箱：[email protected]
🌐 GitHub：@aleosorio22

Karen Jiménez
参与创建 n8n 自动化工作流的协作者。
将后端与 n8n 集成。
测试工作流。
📧 邮箱：[email protected]

---

📄 许可证

此项目采用 MIT 许可证。你可以根据自己的需求修改、复用和调整这些工作流，但必须保留相应署名。

---

💡 最后的说明

此助手可以轻松适配带有 REST API 的其他系统，而不仅限于 ComaPOS。只需调整 HTTP 节点中的 URL 和参数，即可将其集成到任何现代后端。