on (auto-configured in Docker) REDIS_URL=redis://redis:6379/0 # Worker Configuration WORKER_CONCURRENCY=5 # Dashboard Configuration PORT=3001 # Paths (auto-configured in Docker) CONFIG_PATH=/app/config SURVEYS_PATH=/app/surveys ``` --- ## 🛠️ Development ### Hot Reload Development ```bash # Start development environment with hot reload make start-dev # View development logs docker-compose -f docker-compose.dev.yml logs -f ``` ### Local Development (without Docker) ```bash # Start Redis locally docker run -d -p 6379:6379 redis:7-alpine # Install dependencies npm install # Start MCP server npm run dev # Start worker (in separate terminal) cd celery_app celery -A tasks worker --loglevel=info ``` --- ## 📊 Monitoring & Debugging ### 📈 Job Dashboard Access at **http://localhost:3001** to: - ✅ Monitor active/completed jobs - 📋 View job details and progress - 👥 Monitor worker status - ⚡ Real-time job execution tracking ### 💾 Redis Commander Access at **http://localhost:8081** to: - 🔍 Browse Redis keys - 📊 Monitor Redis performance - 👁️ View stored data - 🔧 Debug Redis issues ### 🔧 New MCP Tools - **`send-survey`** - Background job processing for large customer lists - **`get-job-status`** - Monitor background job progress - **`get-queue-stats`** - View job queue statistics ### 📜 Viewing Logs ```bash # All services make logs # Specific service docker-compose logs -f mcp-server docker-compose logs -f job-worker docker-compose logs -f redis # Follow logs in real-time docker-compose logs -f --tail=100 ``` --- ## 🚀 Production Deployment ### Docker Compose Production ```bash # Start production services make start # Scale workers docker-compose up -d --scale job-worker=4 # Update services docker-compose pull docker-compose up -d ``` ### 🏥 Health Checks All services include comprehensive health checks: | Service | Health Check | |---------|--------------| | **Redis** | `redis-cli ping` | | **MCP Server** | Node.js health endpoint | | **Job Worker** | Worker status ping | ### 💾 Persistent Data Data persistence through Docker volumes: | Volume | Purpose | |--------|---------| | `redis_data` | Redis database | | `mcp_config` | ERP configurations | | `mcp_surveys` | Survey definitions | | `mcp_logs` | Application logs | | `worker_logs` | Worker logs | --- ## 🔧 Troubleshooting ### Common Issues

🚫 Services won't start

```bash # Check Docker status docker-compose ps # View service logs make logs # Check system resources docker stats ```

🔴 Redis connection issues

```bash # Test Redis connection make redis-cli ping # Check Redis logs docker-compose logs redis ```

⚠️ Jobs not processing

```bash # Check worker status make logs-celery # Access job dashboard open http://localhost:3001 # Check Redis queue make redis-cli LLEN job_queue ```

🔑 Environment variables not loaded

```bash # Verify .env file exists and is configured cat .env # Restart services make restart # Check environment in container docker-compose exec mcp-server env | grep WHATSAPP ```

### 🔍 Debugging ```bash # Access container shells make shell-mcp # MCP server container make shell-celery # Worker container # View container resources docker stats # Inspect container configuration docker-compose config ``` --- ## 📄 License This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. ---

**⭐ Star this repository if you find it helpful!** [Report Bug](https://github.com/Ronnie-Leon76/whatsapp-flows-mcp-server/issues) · [Request Feature](https://github.com/Ronnie-Leon76/whatsapp-flows-mcp-server/issues) · [Contribute](https://github.com/Ronnie-Leon76/whatsapp-flows-mcp-server/pulls)

2a:T6c2,## What is WhatsApp Flows API MCP Server? WhatsApp Flows API MCP Server is a containerized Model Context Protocol (MCP) server designe

#survey-automation

🚀 WhatsApp Flows API MCP Server