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

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

Local
github.com/aleosorio22AI & Agents1Updated 73w ago
Repository

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

This n8n-based reporting agent connects to ComaPOS to retrieve sales, low-stock, and cash-movement data, then sends reports. Its separate query, delivery, and client workflows can also be adapted to other REST APIs.

Key features

  1. 01Retrieve sales, low-stock, and cash-movement data
  2. 02Support date ranges and custom reports
  3. 03Send reports by email or other channels
  4. 04Orchestrate querying and delivery in n8n

Use cases

  1. 01Send daily sales reports on demand or by schedule
  2. 02Notify teams about low-stock products
  3. 03Generate business reports for a date range

MCP support

The project includes an MCP server workflow for querying the ComaPOS backend, another for sending reports, and an MCP client workflow that invokes both.

#n8n#automation#reporting

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Este repositorio contiene un agente inteligente de reportes desarrollado en n8n, diseñado específicamente para integrarse con el sistema de punto de venta ComaPOS. Utiliza una arquitectura basada en MCP Server y MCP Client para automatizar la generación, consulta y envío de reportes clave del negocio.

📦 ¿Qué hace este agente?

El asistente permite realizar consultas automáticas al backend de ComaPOS para obtener datos como:

  • Ventas del día o por rango de fechas.
  • Productos con stock bajo.
  • Movimientos de caja.
  • Reportes personalizados.

Posteriormente, envía los resultados al canal configurado (correo electrónico, Telegram, etc.) sin intervención humana, todo de forma orquestada a través de flujos de n8n.

🔁 Arquitectura de los Flujos

El sistema está compuesto por tres flujos principales, con funciones bien definidas:

1. MCP Server - Reports

Encargado de realizar las peticiones HTTP al backend de ComaPOS para obtener la información solicitada.

  • Utiliza nodos HTTP Request para consultar endpoints protegidos o públicos del backend (por ejemplo: /api/reportes/ventas-del-dia).
  • Puede recibir parámetros dinámicos desde otros flujos (como fechas o filtros personalizados).
2. MCP Server - Mails

Encargado de enviar reportes por correo electrónico (u otros canales).

  • Utiliza nodos de Gmail, SMTP, o Webhook para integraciones con plataformas externas.
  • Admite personalización del mensaje y adjuntos (PDFs, Excel, JSON).
3. MCP Client

Es el agente maestro que conecta ambos MCP Servers:

  • Recibe comandos u órdenes desde otro sistema (por ejemplo: "enviar reporte de ventas de hoy").
  • Llama a los flujos MCP Server Reports para obtener la información.
  • Luego, invoca MCP Server Mails para enviar la respuesta al usuario.

Esta estructura permite modularidad, escalabilidad y reutilización de componentes para otros agentes o flujos.

🔌 Requisitos Técnicos

  • Instancia de n8n operativa (self-hosted o en la nube).
  • Sistema ComaPOS en producción, con sus APIs REST expuestas y accesibles desde n8n.
  • Conexión configurada a servicios externos de mensajería (como Gmail, Outlook, SendGrid, etc.).
  • Acceso autenticado a los endpoints del backend de ComaPOS (usualmente con token o credenciales JWT).
  • Reglas MCP definidas (como "bajo stock", "ventas hoy", "reporte mensual") según la lógica de negocio.

⚙️ Tecnologías Utilizadas

  • n8n (Flujos de automatización sin código)
  • ComaPOS API (Backend desarrollado en Node.js + MySQL)
  • HTTP Request Nodes
  • Gmail Nodes (o cualquier otro sistema de envío de emails)
  • Webhooks internos para integración A2A (Agent to Agent)

✏️ Ejemplo de Flujo

  1. El MCP Client recibe un trigger para "reporte de ventas de hoy".
  2. Llama al flujo MCP Server Reports, el cual hace un HTTP Request a:
    https://api.comapos.com/api/reportes/ventas-hoy
  3. La respuesta se transforma en un formato legible (JSON, tabla, PDF).
  4. Luego, MCP Server Mails se activa y envía un correo con el reporte al destinatario.

📬 Contacto

¿Tienes dudas, sugerencias o quieres colaborar?

Alejandro Osorio
Desarrollador del sistema ComaPOS y de la arquitectura de automatización.
📧 Email personal: [email protected]
📧 Email empresarial: [email protected]
🌐 GitHub: @aleosorio22

Karen Jiménez
Colaboradora en la creación de los flujos automatizados de n8n. Integracion del backend con n8n. Testing de los flujos. 📧 Email: [email protected]

📄 Licencia

Este proyecto está bajo la licencia MIT. Puedes modificar, reutilizar y adaptar los flujos según tus necesidades, siempre y cuando se mantenga el crédito correspondiente.

💡 Nota Final

Este asistente puede ser adaptado fácilmente a otros sistemas con APIs REST, no únicamente ComaPOS. Basta con ajustar las URLs y parámetros en los nodos HTTP para integrarlo en cualquier backend moderno.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.