vn-luat-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@vn-luat-mcp tra luật về an toàn thực phẩm"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
vn-luat-mcp
MCP server tra cứu pháp luật Việt Nam trên PostgreSQL — gộp Bộ Pháp Điển (luật thành văn, 64k điều) và Án lệ / bản án (toaan.gov.vn). Dùng full-text search tiếng Việt (tìm cả khi gõ không dấu); Claude tự mở rộng từ khóa và xếp hạng để đạt hiệu quả gần ngữ nghĩa.
Chạy được trên Claude Desktop và Claude Code CLI. Kết nối tới PostgreSQL bằng user chỉ-đọc (an toàn).
Công cụ (tools)
Luật thành văn: tra_luat, xem_dieu_luat, tra_luat_theo_chu_de, liet_ke_chu_de, tra_thuat_ngu
Án lệ: tra_an_le, xem_an_le, an_le_theo_dieu_luat (bắc cầu án lệ ↔ điều luật), tra_cau_an_le
Related MCP server: lawyer-mcp
Yêu cầu database
PostgreSQL với extension unaccent, và các bảng: articles, chapters, subjects, ontology_topics, ontology_glossary (pháp điển); anle_documents, anle_sentences (án lệ). Mỗi bảng văn bản có cột search_vector tsvector + chỉ mục GIN.
Tạo user chỉ-đọc:
CREATE USER mcp_ro WITH PASSWORD 'mat_khau_chi_doc';
GRANT CONNECT ON DATABASE appdb TO mcp_ro;
GRANT USAGE ON SCHEMA public TO mcp_ro;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO mcp_ro;
ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON TABLES TO mcp_ro;Cấu hình kết nối (biến môi trường)
PGHOST (mặc định 127.0.0.1), PGPORT (5432), PGDATABASE (appdb), PGUSER (mcp_ro), PGPASSWORD.
Chạy từ GitHub (không cần cài vào máy)
Cần uv (brew install uv). Lệnh chạy server:
uvx --from git+https://github.com/USER/vn-luat-mcp vn-luat-mcpuvx tự tải và tạo môi trường tạm — không lưu bản sao trong dự án của bạn.
Claude Desktop
Sửa ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"luat": {
"command": "uvx",
"args": ["--from", "git+https://github.com/USER/vn-luat-mcp", "vn-luat-mcp"],
"env": {
"PGHOST": "100.85.147.69",
"PGDATABASE": "appdb",
"PGUSER": "mcp_ro",
"PGPASSWORD": "mat_khau_chi_doc"
}
}
}
}Khởi động lại Claude Desktop, rồi thử: "tra luật về an toàn thực phẩm".
Claude Code CLI
Đăng ký nhanh (phạm vi user):
claude mcp add-json luat '{
"command": "uvx",
"args": ["--from", "git+https://github.com/USER/vn-luat-mcp", "vn-luat-mcp"],
"env": {"PGHOST":"100.85.147.69","PGDATABASE":"appdb","PGUSER":"mcp_ro","PGPASSWORD":"mat_khau_chi_doc"}
}'Hoặc dùng theo dự án: sao chép .mcp.json.example thành .mcp.json trong thư mục dự án (đã được .gitignore).
Bảo mật
Chỉ kết nối bằng user chỉ-đọc. Nên đặt PostgreSQL sau mạng riêng (vd Tailscale), không mở ra Internet. Không commit mật khẩu — dùng .env / cấu hình client (đã .gitignore).
License
MIT
Available Tools
12 toolsliet_ke_an_leA
Liệt kê 90 ÁN LỆ CHÍNH THỨC của Việt Nam (số + tiêu đề + năm + số bản án minh họa trong kho). Lọc theo năm nếu cần. Toàn văn: xem_an_le_ct; tìm theo từ khóa: tra_an_le_ct.
Inputs: nam, gioi_han.
liet_ke_chu_deA
Liệt kê các chủ đề (topic) và số đề mục trong Bộ Pháp Điển.
Inputs: no named parameters.
nguon_cua_dieuA
Từ MỘT ĐIỀU pháp điển → VĂN BẢN GỐC + điều gốc + TRÍCH DẪN CHUẨN + tình trạng sửa đổi. Dùng khi cần dẫn nguồn đúng chuẩn (vd 'Điều 385 Bộ luật số 91/2015/QH13') thay vì mã pháp điển, hoặc kiểm tra điều đã bị sửa đổi chưa và bởi văn bản nào. Nhận mã pháp điển (vd '9.1.LQ.385'). Mã ứng nhiều điều → trả danh sách.
Inputs: ma_phap_dien (required).
thong_keA
Đếm/thống kê số lượng trong kho dữ liệu. loai='tong_quan' → tổng điều luật / chủ đề / bản án / án lệ. loai='dieu_luat', nhom_theo='chu_de' → số điều luật theo từng chủ đề. loai='ban_an', nhom_theo='linh_vuc'|'nam'|'toa' → phân bố bản án.
Inputs: loai, nhom_theo.
tim_ngu_nghiaA
Tìm theo NGỮ NGHĨA (semantic) — hiểu ý câu hỏi kể cả khi không trùng từ khóa. Kết hợp vector (pgvector, model đa ngôn ngữ e5-small) + full-text, gộp bằng weighted RRF. nguon: 'an_le' (90 án lệ chính thức, mặc định) hoặc 'dieu_luat' (điều luật thành văn).
CÁCH DÙNG TỐT NHẤT (model nhúng nhỏ nên bạn — Claude — cần hỗ trợ 2 bước):
DIỄN ĐẠT LẠI bằng THUẬT NGỮ PHÁP LÝ trước khi tra. Câu đời thường dễ bị bẫy từ vựng (vd 'công ty nợ lương' → model kéo nhầm sang 'nợ công'). Hãy đổi thành thuật ngữ luật, vd → 'nghĩa vụ trả lương, kỳ hạn trả lương, người sử dụng lao động chậm trả tiền lương'. Nếu chưa chắc, thử vài cách diễn đạt và gộp kết quả.
LẤY RỘNG rồi TỰ LỌC: đọc 'trich_doan' của từng kết quả, GIỮ cái đúng ngữ cảnh, BỎ cái lạc đề (kể cả khi do_tuong_dong cao). Mở toàn văn bằng xem_dieu_luat(ma_phap_dien) / xem_an_le_ct(so).
Với truy vấn đã đúng thuật ngữ/số điều thì tra_luat / tra_an_le_ct (FTS) thường đủ và nhanh hơn. Trả về {tong_so, ket_qua:[...]} — mỗi mục có do_tuong_dong, trich_doan + khóa tra cứu (so/ma_phap_dien).
Inputs: cau_hoi (required), nguon, gioi_han.
tra_an_leA
Tìm ÁN LỆ theo từ khóa (full-text, xếp hạng + 'diem'). Phân trang gioi_han≤50, offset. loai='chinh_thuc' (mặc định): 90 ÁN LỆ CHÍNH THỨC (toàn văn) → so, tieu_de, nam, trich_doan, pdf_url. loai='ban_an' : ~1.963 BẢN ÁN minh họa → precedent_number, title, court_level, year, trich_doan, detail_url. loai='cau' : cấp CÂU trong bản án (trích dẫn chính xác 1 nhận định) → text (câu) + số án lệ nguồn. Câu mơ hồ → có thể rỗng + gợi ý. Trả {tong_so, offset, so_tra, con_nua, ket_qua[...]}.
Inputs: tu_khoa (required), loai, offset, gioi_han.
tra_luatA
Tìm ĐIỀU LUẬT (luật thành văn) theo từ khóa (full-text, tìm cả khi gõ không dấu). Xếp hạng ƯU TIÊN khớp ở TIÊU ĐỀ; mỗi kết quả kèm 'diem' (độ liên quan). chu_de (tùy chọn): tên chủ đề để thu hẹp & tăng chính xác, vd 'Dân sự'. Phân trang: gioi_han tối đa 50; offset để lấy trang kế. LƯU Ý: câu càng NGẮN & đúng thuật ngữ càng chuẩn. Câu dài/mô tả sẽ cho điểm thấp và CÓ THỂ TRẢ RỖNG — khi đó rút gọn còn từ khóa cốt lõi (vd 'hợp đồng', 'thừa kế') hoặc thêm chu_de. Trả về {tong_so, offset, so_tra, con_nua, ket_qua[...]}; hoặc rỗng kèm goi_y nếu khớp quá yếu.
Inputs: tu_khoa (required), chu_de, offset, gioi_han.
tra_thuat_nguC
Tra từ điển thuật ngữ pháp lý Việt–Anh.
Inputs: tu (required), gioi_han.
tra_van_banA
Tìm trong TOÀN VĂN văn bản gốc (Công báo). Chạm được phần pháp điển LƯỢC BỎ: căn cứ ban hành, lời nói đầu, phụ lục, biểu mẫu, điều khoản chuyển tiếp/thi hành. loai (tùy chọn): lọc theo loại vd 'Nghị định', 'Thông tư', 'Luật'. chu_de (tùy chọn): lọc nhóm CHƯA được pháp điển hóa — 'Đất đai' | 'Thi đua'. ⚠ Hai lĩnh vực này KHÔNG có trong pháp điển (chủ đề 11, 29 Bộ Tư pháp chưa công bố), nên tra_luat/tim_ngu_nghia KHÔNG tìm ra. Muốn tra đất đai → DÙNG TOOL NÀY với chu_de='Đất đai'. Khác tra_luat (tra điều đã pháp điển hóa) — dùng khi cần bản gốc đầy đủ.
Inputs: tu_khoa (required), loai, chu_de, offset, +1 more.
xem_an_leA
Xem TOÀN VĂN một án lệ/bản án — TỰ NHẬN DIỆN: • Số án lệ chính thức, vd '79/2025/AL' hoặc 'Án lệ số 79/2025/AL' → 90 án lệ chính thức. • precedent_number / doc_name khác → bản án minh họa. Mặc định cắt ngắn (~3000/1500 ký tự); day_du=True lấy toàn văn. Nhiều bản án minh họa → trả danh sách chọn.
Inputs: dinh_danh (required), day_du.
xem_dieu_luatA
Xem toàn văn một điều luật. Nhận CẢ BA dạng, tự nhận diện: • Mã pháp điển: '9.1.LQ.623' (hoặc có tiền tố 'Điều 9.1.LQ.623') • Anchor số có dấu #: '#0900...' • Anchor số không dấu #: '0900...' Nếu một mã ứng với nhiều điều, trả về danh sách ứng viên kèm anchor để chọn lại.
Inputs: ma_dieu (required).
xem_van_ban_gocA
Xem VĂN BẢN GỐC theo số hiệu (vd '91/2015/QH13', '155/2020/NĐ-CP'): metadata chính thức (cơ quan ban hành, ngày ban hành/hiệu lực, người ký) + TOÀN VĂN từ Công báo Chính phủ. LƯU Ý: số hiệu KHÔNG duy nhất — cùng '91/2015/QH13' có cả Luật (Bộ luật Dân sự) lẫn Nghị quyết. Nếu trùng, tool trả danh sách; chọn bằng loai='Luật' | 'Nghị quyết' | 'Nghị định'… Mặc định cắt ~15.000 ký tự; day_du=True lấy trọn.
Inputs: so_hieu (required), loai, day_du.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Tools are mostly distinct but there is potential confusion between semantic search (tim_ngu_nghia) and keyword search (tra_luat, tra_van_ban). Descriptions clarify usage, but slight overlap exists.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., liet_ke_an_le, tra_luat, xem_dieu_luat). No mixed conventions.
12 tools is well-scoped for a legal research server, covering searching, viewing, listing, statistics, and term lookups without being overwhelming.
The tool set covers core CRUD operations for legal documents and case law. Minor gaps exist, such as no direct tool to list all documents by date or type, but semantic search compensates.
Related MCP Connectors
MCP server for Chinese law lookup: statutes, regulations and articles by keyword or law name.
Taiwan legal research MCP by Dr.Legal (法律偵探): 22.7M court judgments, current statutes, administrative rulings and Constitutional Court decisions. Retrieval-only, per-item citations, appeal-chain history, bundle-level citation audit. Free, no API key; OAuth 2.0 dynamic registration completes automatically. 台灣法律 MCP:2,272 萬筆裁判書、法規、函釋、憲法法庭裁判,逐筆附出處並提供引用查核。免費、免金鑰。Docs: https://dr-legal.com.tw/mcp
Law firm management MCP: manage cases, clients, tasks, calendar and documents via Claude AI.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for searching and retrieving Japanese laws from the e-Gov API, enabling natural language queries for legal information.37 npmMIT
- FlicenseAqualityDmaintenanceMCP server for Legalize.dev, enabling AI to query and understand legal frameworks across countries via a structured legislation API.131-
- AlicenseAqualityBmaintenanceMCP server for querying French legislation and case law via the Legifrance API, enabling search and retrieval of laws, codes, and court decisions with verifiable citations.881 PyPI2Apache 2.0
- FlicenseAqualityBmaintenanceLocal MCP server that provides Italian legal assistance by querying a local corpus of Italian legislation, integrated with Claude Desktop.3-