Bỏ qua điều hướng - vào nội dung chính

MCP Server

Model Context Protocol server cho VietLex — Claude/ChatGPT/Gemini connect trực tiếp tra cứu văn bản pháp luật.

Anthropic Model Context Protocol

MCP Server VietLex — Cài 1 dòng để AI tra cứu pháp luật VN trực tiếp

Cài 1 dòng vào Claude Desktop / Cursor / Continue / Cline — AI tự tra cứu 84.000 văn bản pháp luật Việt Nam, trích chính xác Điều/Khoản, link xác thực. Mã nguồn mở MIT, miễn phí 100%.

Cài đặt vào Claude Desktop (5 phút)

  1. Mở file config Claude Desktop:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json
  2. Thêm khối mcpServers (nếu file đã có, merge vào):
    {
      "mcpServers": {
        "vietlex": {
          "command": "npx",
          "args": ["-y", "@vietlex/mcp-server"],
          "env": {
            "VIETLEX_API_BASE": "https://vietlex.vn/api/v1"
          }
        }
      }
    }
  3. Khởi động lại Claude Desktop.
  4. Test: hỏi Claude một câu pháp luật VN, vd:

    Tôi cần tra Luật Doanh nghiệp Việt Nam ban hành năm 2020, có quy định gì về vốn điều lệ tối thiểu của công ty TNHH? Trích chính xác Điều/Khoản kèm link gốc.

    Claude sẽ tự gọi vietlex.search + vietlex.get_document và trả lời với link xác thực:
    Theo Luật Doanh nghiệp số 59/2020/QH14 ban hành ngày 17/6/2020 (vietlex.vn/luat/luat/2020/59):
    
    - Điều 47 khoản 1: "Vốn điều lệ của công ty trách nhiệm hữu hạn hai thành viên trở lên..."
    - Điều 75 khoản 1: "Vốn điều lệ của công ty trách nhiệm hữu hạn một thành viên..."
    
    Lưu ý: Luật KHÔNG quy định mức vốn điều lệ tối thiểu cho TNHH (trừ một số ngành nghề yêu cầu vốn pháp định riêng — xem Điều 7 + danh mục Nghị định 31/2021).
    
    Nguồn: VietLex.vn (84.000 văn bản pháp luật Việt Nam) — tra cứu qua MCP Server

5 tools mà MCP Server cung cấp

vietlex.search

Tìm văn bản pháp luật theo từ khoá, lĩnh vực, năm, loại, địa phương

Args: q (string), loai (string?), nam (number?), linh_vuc (string?), dia_phuong (string?), limit (number? = 10)

search({ q: "doanh nghiệp", loai: "Luật", nam: 2020 }) → [{ id, soHieu, title, ngayBanHanh, url }, ...]

vietlex.get_document

Lấy chi tiết 1 văn bản pháp luật: metadata + fulltext (nếu có) + tham chiếu chéo

Args: id (string, vd "doc_123456")

get_document({ id: "doc_123456" }) → { id, soHieu, loai, title, ngayBanHanh, capBanHanh, linhVuc, fulltext, citator, url }

vietlex.citator

Lấy đồ thị quan hệ pháp lý: văn bản pháp luật nào sửa đổi, bãi bỏ, dẫn chiếu, hợp nhất với văn bản pháp luật này

Args: id (string)

citator({ id: "doc_59_2020" }) → { tier: "green", inbound: [...], outbound: [...] }

vietlex.compare

So sánh 2 phiên bản văn bản pháp luật (vd luật cũ vs luật sửa đổi)

Args: id_a (string), id_b (string)

compare({ id_a: "doc_old", id_b: "doc_new" }) → { added: [...], removed: [...], changed: [...] }

vietlex.list_recent

Liệt kê văn bản pháp luật mới ban hành theo cấp ban hành / lĩnh vực

Args: capBanHanh (string?), linhVuc (string?), days (number? = 7), limit (number? = 20)

list_recent({ days: 30 }) → [{ id, soHieu, title, ngayBanHanh, url }, ...]

MCP Server hỗ trợ những AI client nào?

  • Claude Desktop (Anthropic, macOS/Windows/Linux) — official MCP client
  • Cursor IDE — code editor với AI assistant tích hợp MCP
  • Continue — VSCode/JetBrains extension
  • Cline (formerly Claude Dev) — autonomous coding agent
  • Zed editor — text editor mới với MCP support
  • Sage, 5ire, LibreChat, Witsy — open-source AI chat apps

Danh sách MCP client cập nhật tại modelcontextprotocol.io/clients

Trạng thái phát triển

  • MCP Server v1.0 đang được VietLex phát triển. Repo sẽ public tại github.com/vietlex-vn/mcp-server.
  • Trong khi chờ NPM package, lập trình viên có thể tự build từ source khi repo public.
  • VietLex cam kết: API miễn phí vĩnh viễn, không quota, dữ liệu cập nhật mỗi 1-2 giờ.