my-db-mate

mcp
Security Audit
Warn
Health Warn
  • License — License: NOASSERTION
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 6 GitHub stars
Code Warn
  • process.env — Environment variable access in drizzle.config.ts
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Self-hosted chat-with-your-database: natural-language questions answered by real read-only SQL, with a curated context layer and a physical safety layer. Next.js + TypeScript.

README.md

My DB Mate

English | Tiếng Việt

Chat với database của bạn. Hỏi bằng ngôn ngữ tự nhiên, nhận câu trả lời dựa trên SQL thật, không cần viết truy vấn tay.

Chat với database: câu hỏi → SQL → chart


Tại sao tôi làm sản phẩm này

Sản phẩm này dành cho DevOps/DBA quản lý database lớn trong production, ngày nào cũng nhận yêu cầu lấy data ad-hoc từ business, product, finance. Dashboard có sẵn thì cứng, thiếu đúng lát cắt data người ta cần. Viết SQL tay mỗi lần thì tốn thời gian, nhất là hệ thống nhiều bảng, business logic chồng chéo.

Vấn đề không phải là convert câu hỏi thành SQL. LLM giờ làm việc đó khá tốt rồi. Vấn đề là context để AI generate đúng: usr_stat_cd nghĩa là gì, "khách hàng active" map vào cấu trúc DB nào, những quy ước chỉ có trong đầu DBA chứ không nằm trong schema. LLM đoán được tên viết tắt thông thường, nhưng không đoán được enum code mờ nghĩa hay tri thức riêng của từng hệ thống. Chỗ đó phải do người dùng bồi đắp dần, không có LLM nào tự lấp được.

Nên My DB Mate không đặt cược vào text-to-SQL. Nó đặt cược vào một lớp context (glossary, chú thích schema, verified queries) mà bạn xây theo thời gian, để AI hiểu đúng hệ thống của bạn hơn.

Và vì đây là DB production, an toàn là điều kiện bắt buộc chứ không phải tính năng thêm: chỉ đọc ép ở nhiều tầng, mọi truy vấn qua một điểm kiểm duyệt, credential mã hoá, mọi lần chạy có audit log.


Bắt đầu

Bạn là… Đọc file này
Người dùng muốn tự cài & dùng Hướng dẫn sử dụng (tiếng Việt)
Nhờ một AI agent cài giúp ("đọc file này rồi cài + hướng dẫn tôi") docs/agent-setup.md
Muốn xem làm được gì + stack + safety model Features & Technical Reference

Cài nhanh (cần Docker):

./setup.sh                          # tạo .env, sinh khoá mã hoá, hỏi OpenRouter key
docker compose --profile full up    # app + DB + tự migrate → http://localhost:3000

Giấy phép

Phát hành theo PolyForm Noncommercial License 1.0.0 — tự do dùng, sửa, chia sẻ cho mọi mục đích phi thương mại (cá nhân, học tập, nghiên cứu, tổ chức phi lợi nhuận).

Dùng cho mục đích thương mại cần giấy phép riêng — liên hệ tác giả tại [email protected].

Copyright © 2026 Trọng Phúc (phuc-nt).

Reviews (0)

No results found