upd

Author: dadadadas111

.env.example

@@ -3,25 +3,34 @@ NODE_ENV=development
 PORT=3001
 HOST=0.0.0.0
 
-# Main IoT Cloud REST API
+# IoT Cloud REST API
+# Required: Base URL for the IoT Cloud API
 IOT_API_BASE_URL=https://staging.openapi.rogo.com.vn/api/v2.0/iot-core
-IOT_API_KEY=f6883470-bd95-4e23-9ee6-51e878386451
-IOT_API_TIMEOUT=30000
 
-# Firebase Admin SDK
-# Option 1: Path to service account JSON file
-FIREBASE_SERVICE_ACCOUNT_PATH=./firebase-service-account.json
-# Option 2: Inline JSON (for deployment platforms like Heroku, Railway)
-# FIREBASE_SERVICE_ACCOUNT={"type":"service_account","project_id":"..."}
+# Required: API Key for authentication with IoT Cloud API
+IOT_API_KEY=your-api-key-here
+
+# Optional: Request timeout in milliseconds (default: 30000)
+IOT_API_TIMEOUT=30000
 
 # CORS Configuration
+# Enable CORS for cross-origin requests
 ENABLE_CORS=true
+
+# Comma-separated list of allowed origins
+# Use * to allow all origins (not recommended for production)
 CORS_ORIGINS=http://localhost:3000,https://chat.openai.com,https://claude.ai
 
 # Rate Limiting
+# Enable rate limiting to prevent abuse
 ENABLE_RATE_LIMIT=true
+
+# Maximum number of requests per window
 RATE_LIMIT_MAX=100
+
+# Time window in milliseconds (default: 1 minute)
 RATE_LIMIT_WINDOW=60000
 
 # Logging
-LOG_LEVEL=debug
+# Log level: debug, info, warn, error
+LOG_LEVEL=info

.github/workflows/docker-build.yml

@@ -17,12 +17,11 @@ env:
   IMAGE_NAME: ${{ github.repository }}
 
 jobs:
-
   build-and-push:
     name: Build and Push Docker Image
     runs-on: ubuntu-latest
     if: github.event_name == 'push' && (github.ref == 'refs/heads/master' || github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/v'))
-    
+
     permissions:
       contents: read
       packages: write
@@ -75,3 +74,63 @@ jobs:
 
       - name: Image digest
         run: echo ${{ steps.meta.outputs.digest }}
+
+  deploy:
+    name: Deploy to VPS
+    needs: build-and-push
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && (github.ref == 'refs/heads/master' || github.ref == 'refs/heads/main')
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup SSH key
+        run: |
+          mkdir -p ~/.ssh
+          echo "${{ secrets.VPS_KEY_BASE64 }}" | base64 -d > ~/.ssh/deploy_key
+          chmod 600 ~/.ssh/deploy_key
+          ssh-keyscan -p ${{ secrets.VPS_PORT }} ${{ secrets.VPS_HOST }} >> ~/.ssh/known_hosts
+
+      - name: Deploy to VPS via SSH
+        run: |
+          ssh -i ~/.ssh/deploy_key -p ${{ secrets.VPS_PORT }} ${{ secrets.VPS_USERNAME }}@${{ secrets.VPS_HOST }} << 'ENDSSH'
+            set -e
+            
+            # Navigate to project directory
+            cd /opt/mcp
+            
+            # Login to GitHub Container Registry
+            echo ${{ secrets.GITHUB_TOKEN }} | sudo docker login ghcr.io -u ${{ github.actor }} --password-stdin
+            
+            # Pull the latest image
+            sudo docker pull ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:latest
+            
+            # Detect docker-compose version and use appropriate command
+            if command -v docker-compose &> /dev/null; then
+                COMPOSE_CMD="sudo docker-compose"
+            else
+                COMPOSE_CMD="sudo docker compose"
+            fi
+            
+            # Stop and remove old containers
+            $COMPOSE_CMD down || true
+            
+            # Start services with the new image
+            $COMPOSE_CMD up -d
+            
+            # Wait for services to be healthy
+            echo "Waiting for services to start..."
+            sleep 15
+            
+            # Check service status
+            $COMPOSE_CMD ps
+            
+            # Show recent logs
+            $COMPOSE_CMD logs --tail=50 iot-cloud-mcp
+            
+            # Clean up old images
+            sudo docker image prune -af --filter "until=24h"
+            
+            echo "Deployment completed successfully!"
+          ENDSSH

QUICKSTART.md

@@ -0,0 +1,134 @@
+# Quick Start Guide
+
+## 🚀 Get Started in 5 Minutes
+
+### 1. Install Dependencies
+
+```bash
+npm install
+```
+
+### 2. Configure Environment
+
+```bash
+cp .env.example .env
+```
+
+Edit `.env` and add your IoT Cloud API credentials:
+
+```env
+IOT_API_BASE_URL=https://staging.openapi.rogo.com.vn/api/v2.0/iot-core
+IOT_API_KEY=your-api-key-here
+```
+
+### 3. Start the Server
+
+```bash
+npm run start:dev
+```
+
+Server will start at: **http://localhost:3001**
+
+### 4. Test the Connection
+
+In a new terminal, run the test script:
+
+```bash
+node test-mcp.js
+```
+
+You should see:
+
+```
+✅ Connected! Status: 200
+✅ MCP Server initialized successfully!
+✅ Received 7 tools: login, get_devices, get_device, ...
+✅ Server is ready!
+🎉 All checks passed!
+```
+
+### 5. Connect Your AI Agent
+
+#### For Claude Desktop
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "iot-cloud": {
+      "url": "http://localhost:3001/api/mcp/sse"
+    }
+  }
+}
+```
+
+Restart Claude Desktop, then try:
+
+```
+You: Login to my IoT account with email user@example.com and password mypassword
+```
+
+Claude will use the `login` tool to authenticate you!
+
+## 📚 Next Steps
+
+- **Read the [README.md](./README.md)** for full documentation
+- **Check [API Documentation](http://localhost:3001/api/docs)** for available endpoints
+- **Explore [MCP Protocol](./docs/MCP_PROTOCOL.md)** for technical details
+
+## 🔧 Troubleshooting
+
+### Server won't start
+
+**Error:** `Cannot find module`
+
+**Solution:**
+
+```bash
+rm -rf node_modules package-lock.json
+npm install
+```
+
+### Cannot connect to IoT API
+
+**Error:** `ECONNREFUSED`
+
+**Solution:**
+
+- Verify `IOT_API_BASE_URL` in `.env`
+- Check your network/firewall settings
+- Test API directly: `curl https://your-api-url/health`
+
+### Test script fails
+
+**Error:** `Connection error`
+
+**Solution:**
+
+- Make sure server is running: `npm run start:dev`
+- Check port 3001 is not in use: `lsof -i :3001`
+
+## 💡 Tips
+
+1. **Use debug logging** during development:
+
+   ```env
+   LOG_LEVEL=debug
+   ```
+
+2. **Enable CORS** for web clients:
+
+   ```env
+   ENABLE_CORS=true
+   CORS_ORIGINS=http://localhost:3000
+   ```
+
+3. **Increase rate limits** for testing:
+   ```env
+   RATE_LIMIT_MAX=1000
+   ```
+
+## ✅ You're Ready!
+
+Your MCP server is now ready to bridge AI agents with your IoT devices!