Monadomain MCP server

monacloud-mcp

monacloud-mcp là MCP hợp nhất của MONA Cloud: cài một lần, đăng nhập một MONA Pass và dùng chung ví VND để quản lý tài khoản, chạy app/VPS, tạo Base beta thay Supabase, tích hợp MONA Pay, gửi email giao dịch bằng MONA Mail và đọc catalog MONA Agent ngay trong Claude Code, Codex hoặc Cursor.

Human đăng ký MONA Pass một lần, duyệt chi phí, thêm DNS khi cần, quét QR nạp ví do AI tạo và cung cấp OTP/KYC khi bắt buộc. Các bước tạo yêu cầu nạp, tạo tài nguyên, đọc trạng thái, cấu hình webhook, test và deploy được thiết kế để AI agent làm qua MCP.

0.8.1 — luật nạp ví đứng đầu instructions

Codex chỉ chắc chắn đọc 512 ký tự đầu của instructions MCP, nên luật "ví thiếu → AI tự gọi cloudtopup, in QR" được đưa lên đầu; mô tả hệ và APPFLOW đặt sau. Kiểm thử 17/09: Claude Code (sonnet) và Gemini (Antigravity CLI) tự gọi cloudtopup và in QR khi người dùng nói "ví hết tiền, nạp 50k"; Codex chạy headless (codex exec) mặc định chặn mọi lời gọi MCP theo approval policy; thêm --approve-for-me thì Codex cũng tự gọi cloudtopup và in QR (kiểm 17/09). Codex tương tác thì duyệt lời gọi tool như bình thường.

0.8.0 — Nạp ví ngay trong terminal

Ví thiếu tiền thì AI gọi cloudtopup(amount); MCP trả qrascii (QR VietQR chuẩn EMVCo/NAPAS in bằng khối đầy ██, Claude Code/Codex/Gemini CLI hiện được ngay; terminal nền sáng dùng qrasciilight, bản gọn qrasciismall; đã giải mã được bằng ZBar và OpenCV ở cả hai nền), qrfile (PNG tại ~/.config/monacloud/), qrurl (ảnh VietQR) cùng ngân hàng, số tài khoản, số tiền, nội dung chuyển khoản. Người dùng mở app ngân hàng quét màn hình, tiền vào tự cộng ví; AI gọi cloudtopupstatus(topupid) tới khi paid rồi làm tiếp. base64 không còn nằm trong text (tiết kiệm 15–25k token mỗi lần). Khi ví chung (billing) chưa nhận token hoặc merchant MONA Pay chưa cấu hình, cloudtopup tự chuyển sang đường compute /api/payments/vietqr (ví local, prefix VIBECLOUD, báo có tự cộng).

0.5.0 — MONA Base beta

Thêm cloudbasecreate/list/get/delete/credentials cùng alias vibecloudbase. Base thay Supabase, chung MONA Pass/ví MONA Cloud và khớp app deploy. Sandbox chỉ ước tính, không provision; chờ Base provision-live trước khi publish package.

0.4.0 — Đưa thư mục hiện tại lên web

Prompt Claude Code: “Đưa dự án này lên MONA Cloud, dùng thư mục hiện tại”.

AI làm 99%: cloudappdetect(localdir) offline → đọc host và giá → sandbox nếu cần host mới → hỏi duyệt chi phí một lần → cloudappcreate(localdir) → kiểm và trả URL. Có domain riêng thì cloudappdomainadd và hướng dẫn CNAME. Human đăng ký MONA Pass qua device flow; hết credit 20k thì AI gọi cloudtopup và in QR, human chỉ quét.

cloud_app_detect({ local_dir: "/absolute/path/to/project" })
cloud_app_create({ local_dir: "/absolute/path/to/project", name: "shop", sandbox: true })
// Sau khi đã duyệt chi phí
cloud_app_create({ local_dir: "/absolute/path/to/project", name: "shop" })
cloud_app_deploy({ app_id: "<app_id>", local_dir: "/absolute/path/to/project" })

ZIP tối đa 80 MiB, loại .env, .pem, .git, nodemodules và symlink; áp dụng .gitignore/.dockerignore. dist được giữ mặc định. Git vẫn dùng repourl như trước. Hợp đồng upload, giới hạn và cách tiếp tục job.

Yêu cầu

Shortened. The full README is on GitHub.