Skip to main content
Glama

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-mcp

uvx 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 tools
liet_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):

  1. 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ả.

  2. 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

    A3.9/5.0

    Scored across 12 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    12 tools is well-scoped for a legal research server, covering searching, viewing, listing, statistics, and term lookups without being overwhelming.

    Completeness4/5

    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

    Related MCP Servers