🚀 E-Commerce MCP Dashboard & Server

AI-Powered Analytics Dashboard + MCP Server สำหรับ E-commerce ของคุณ

ช่วยให้ AI สามารถ:

• 📊 ดูข้อมูล - สินค้า, คำสั่งซื้อ, คูปอง
• 🎮 สั่งงาน - เปลี่ยนราคา, อัพเดท stock, สร้างคูปอง
• 📈 วิเคราะห์ - ยอดขาย, กำไร, รายงาน
• 🔔 แจ้งเตือน - Stock ต่ำ, Order รออยู่

---

✅ ตรวจสอบการติดตั้ง

✅ Flask Server ทำงานที่ http://localhost:5000 ✅ MCP Server พร้อมใช้ (โครงสร้าง JSON-RPC) ✅ Database เชื่อมต่อ: /Users/bookk/Documents/FULL_BACKUP_20260503_0050/data/shop_main.sqlite ✅ API Endpoints 20+ endpoints พร้อมใช้งาน

---

🌐 วิธีใช้งาน

บนคอมพิวเตอร์:

1. รัน Flask Server (Dashboard + REST API):

cd /Users/bookntp/Desktop/ecommerce-mcp
python3 app.py
# เปิด http://localhost:5000

2. เข้า Dashboard:

# Option A: ผ่าน Browser โดยตรง
http://localhost:8000/dashboard.html

# Option B: เปิด HTTP Server (ใหม่)
python3 -m http.server 8000
# แล้วเปิด http://localhost:8000/dashboard.html

บนมือถือ (เดือก Network เดียว):

1. ดูว่า IP ของคอม: 192.168.X.X
2. เปิด Browser มือถือ: http://192.168.X.X:8000/dashboard.html

---

🤖 ใช้งานกับ AI (MCP Server)

วิธี 1: Claude Desktop (ทำเลย!)

1. หา config file ของ Claude Desktop:

   Mac: ~/Library/Application\ Support/Claude/claude_desktop_config.json
   Windows: %APPDATA%\Claude\claude_desktop_config.json
   

2. เปิด file และเพิ่มส่วนนี้:

   {
     "mcpServers": {
       "ecommerce": {
         "command": "python3",
         "args": ["/Users/bookntp/Desktop/ecommerce-mcp/mcp_server.py"]
       }
     }
   }
   

3. รีสตาร์ท Claude Desktop

4. ตอนนี้สามารถใช้ MCP Tools ได้แล้ว!

ตัวอย่างการใช้งาน:

ผม (AI): "ช่วยดูสินค้าที่ stock ต่ำสุด 5 ชิ้น"
         ↓
Claude → เรียก tool: product_low_stock(threshold=5)
         ↓
MCP Server → Query database
         ↓
ผม: "พบ 3 สินค้า..."

---

📊 ฟีเจอร์ Dashboard

KPI Cards:

• 💰 ยอดรวม - ยอดขายทั้งหมด
• 📦 คำสั่งซื้อ - จำนวนรวม
• 📈 กำไรสุทธิ - ผลประกอบการ
• 🚨 Stock ต่ำ - สินค้าต้องจัดเก็บ

รายละเอียด:

• 🚨 สินค้า Stock ต่ำ
• 📋 คำสั่งซื้อล่าสุด
• ⭐ ลูกค้า Top 5
• 🏷️ คูปองใช้ได้

---

🔌 API Endpoints

Read Operations (GET)

Endpoint	คำอธิบาย
GET /api/dashboard	Dashboard สรุปทั้งหมด
GET /api/products	ดึงสินค้า
GET /api/products/low-stock	สินค้า stock ต่ำ
GET /api/products/stats	สถิติสินค้า
GET /api/orders	ดึงคำสั่งซื้อ
GET /api/orders/stats	สถิติคำสั่งซื้อ
GET /api/coupons	ดึงคูปอง
GET /api/coupons/usage	ผลใช้คูปอง
GET /api/sales/analytics	วิเคราะห์ยอดขาย
GET /api/sales/profit	คำนวณกำไร
GET /api/users	ดึงผู้ใช้
GET /api/users/top	ลูกค้า Top N
GET /api/alerts	ดึงเตือน
GET /api/reports/sales	รายงานขาย
GET /api/reports/products	รายงานสินค้า

Write Operations (POST/PUT/DELETE)

Method	Endpoint	คำอธิบาย
PUT	/api/products/<id>/price	เปลี่ยนราคา
PUT	/api/products/<id>/stock	อัพเดท Stock
DELETE	/api/products/<id>	ลบสินค้า
POST	/api/coupons	สร้างคูปอง
POST	/api/coupons/cleanup	ลบคูปองหมดอายุ
PUT	/api/coupons/<id>/disable	ปิดใช้คูปอง
PUT	/api/orders/<id>/status	เปลี่ยนสถานะ Order
PUT	/api/orders/<id>/payment-status	เปลี่ยนสถานะชำระเงิน
POST	/api/maintenance/backup	Backup Database
POST	/api/maintenance/cleanup	ล้าง Log เก่า

---

🎮 MCP Tools

Product Tools:

• product_update_price - เปลี่ยนราคาสินค้า
• product_update_stock - อัพเดท Stock
• product_delete - ลบสินค้า
• product_low_stock - ดูสินค้า Stock ต่ำ

Coupon Tools:

• coupon_create - สร้างคูปองใหม่
• coupon_cleanup_expired - ลบคูปองหมดอายุ
• coupon_disable - ปิดใช้คูปอง

Order Tools:

• order_update_status - เปลี่ยนสถานะ (pending/processing/shipped/delivered/cancelled)
• order_update_payment - เปลี่ยนสถานะชำระเงิน (unpaid/paid/refunded)

Reporting Tools:

• report_sales - สรุปยอดขาย (รองรับวันที่)
• report_products - รายงานกำไรสินค้า

Alert Tools:

• get_alerts - ดึงเตือนระบบ (Low Stock, Unpaid Orders, Expired Coupons)

Maintenance Tools:

• backup_database - Backup Database
• cleanup_old_logs - ล้าง Log เก่า

---

🛠️ ตัวอย่าง API Usage

ดึงสินค้า Stock ต่ำ:

curl http://localhost:5000/api/products/low-stock?threshold=5

เปลี่ยนราคาสินค้า:

curl -X PUT http://localhost:5000/api/products/1/price \
  -H "Content-Type: application/json" \
  -d '{"price": 2500}'

สร้างคูปองใหม่:

curl -X POST http://localhost:5000/api/coupons \
  -H "Content-Type: application/json" \
  -d '{
    "code": "SUMMER20",
    "name": "Summer Sale",
    "discount_type": "PERCENTAGE",
    "discount_value": 20,
    "min_order": 1000,
    "expiry_days": 30
  }'

อัพเดท Order Status:

curl -X PUT http://localhost:5000/api/orders/5/status \
  -H "Content-Type: application/json" \
  -d '{"status": "shipped"}'

ดึงยอดขาย:

curl http://localhost:5000/api/sales/analytics

ดึง Alert ระบบ:

curl http://localhost:5000/api/alerts

---

🔄 Auto-Refresh

Dashboard จะ auto-refresh ทุก 30 วินาที เพื่อดึงข้อมูลล่าสุด

---

📂 Project Structure

ecommerce-mcp/
├── app.py                          ← Flask API Server
├── mcp_server.py                   ← MCP Server (สำหรับ Claude/AI)
├── database.py                     ← Database Connection & Queries
├── dashboard.html                  ← Dashboard UI
├── claude_desktop_config.json      ← Config สำหรับ Claude Desktop
├── requirements.txt                ← Dependencies
└── README.md                       ← นี่คือไฟล์นี้

---

🚀 การรัน (อย่างละเอียด)

Step 1: รัน Flask Server

cd /Users/bookntp/Desktop/ecommerce-mcp
python3 app.py

# Output:
# * Running on http://127.0.0.1:5000
# * Running on http://192.168.0.20:5000

Step 2: เข้า Dashboard (ในเทอร์มินอล/TTY ใหม่)

cd /Users/bookntp/Desktop/ecommerce-mcp
python3 -m http.server 8000

# แล้วเปิด: http://localhost:8000/dashboard.html

Step 3: ตั้งค่า Claude Desktop (Optional)

• ทำตามขั้นตอน "วิธี 1: Claude Desktop" ด้านบน
• รีสตาร์ท Claude Desktop
• ตอนนี้สามารถใช้ MCP Tools ได้!

---

⚠️ ข้อควรรู้

• 🔒 ไม่มี Authentication - สำหรับ Dev/Testing เท่านั้น
• 📡 CORS เปิด - สามารถเข้าจาก Domain ใดๆ
• 🗄️ SQLite ใช้ Read-Only (Dashboard) - ไม่ Edit ข้อมูล (ปลอดภัย)
• ✏️ Write Operations - ผ่าน API/MCP Toolsเท่านั้น
• 📝 Auto Backup - เมื่อใช้ tool backup_database

---

🔧 Troubleshooting

Port 5000 ถูกใช้งาน:

# หาว่าใครใช้
lsof -i :5000

# ปิด process
kill -9 <PID>

Dashboard ไม่โหลด:

• ตรวจสอบ Flask Server กำลังรัน
• ตรวจสอบ CORS ไม่ block
• ดู Browser Console สำหรับ errors

MCP Tools ไม่ทำงาน:

• ตรวจสอบ config file ของ Claude Desktop
• ตรวจสอบ path สมบูรณ์
• รีสตาร์ท Claude Desktop

---

📝 Notes

• Database อัพเดทแบบ Real-time
• Dashboard cache บน Browser แต่ refresh ทุก 30 วินาที
• มี Error handling สำหรับเมื่อ API ไม่ตอบสนอง
• MCP Server เปิด JSON-RPC protocol สำหรับ AI tools

---

💡 ไอเดียสำหรับอนาคต

• 🔐 Add Authentication (JWT/API Keys)
• 📨 Email Notifications
• 📞 Telegram Bot Integration
• 📊 Advanced Analytics & Charts
• 🔄 Real-time Sync ด้วย WebSocket
• 🗄️ Multi-database Support

---

สร้างโดย: Copilot (GitHub)
เวอร์ชัน: 2.0.0 (MCP Upgrade)
สุดท้ายอัพเดท: 2026-05-03
Status: ✅ Ready for Production (Dev Mode)