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

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