🚀 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 (ทำเลย!)

หา config file ของ Claude Desktop:

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

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

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

รีสตาร์ท Claude Desktop
ตอนนี้สามารถใช้ 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)

ecommerce-mcp