{"_id":"@ansvar/vietnamese-law-mcp","_rev":"3-87367976f8c6bdb0acd4e3f2de52f9a9","name":"@ansvar/vietnamese-law-mcp","dist-tags":{"latest":"2.0.0"},"versions":{"1.0.1":{"name":"@ansvar/vietnamese-law-mcp","version":"1.0.1","keywords":["mcp","model-context-protocol","vietnamese-law","cybersecurity-law","personal-data-protection","information-technology","enterprise-law","e-transactions","consumer-rights","legislation","legal","compliance","asean","ansvar"],"author":{"name":"Ansvar Systems","email":"hello@ansvar.eu"},"license":"Apache-2.0","_id":"@ansvar/vietnamese-law-mcp@1.0.1","maintainers":[{"name":"ansvar","email":"jeffrey.von.rotz@ansvar.eu"}],"homepage":"https://ansvar.eu","bugs":{"url":"https://github.com/Ansvar-Systems/vietnamese-law-mcp/issues"},"bin":{"vietnamese-law-mcp":"dist/index.js"},"dist":{"shasum":"acf99182257d77a32e33da7b36aa353a44771090","tarball":"https://registry.npmjs.org/@ansvar/vietnamese-law-mcp/-/vietnamese-law-mcp-1.0.1.tgz","fileCount":117,"integrity":"sha512-q57TMsZ5CsXvkPl3RrPxR+OD6sSo65l05Q2aV+uLrSORaEX8jBd57byGwb79BWot8J+GzuUw2VY7ta4aitYxCA==","signatures":[{"sig":"MEUCIQCD5caZUpqEeATxEKMqfhpgpUfSqJFO2MRXQi5LmA7p2wIgW3M2Vl7G+sw/UU3up8siN+tUdur4rJOQPgRXAYBILhU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ansvar%2fvietnamese-law-mcp@1.0.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":3464857},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"9f1d5f981ff5d5d3e721af06920bc691c8d2256e","mcpName":"eu.ansvar/vietnamese-law-mcp","scripts":{"dev":"node --import tsx src/index.ts","lint":"tsc --noEmit","test":"vitest run","build":"tsc","start":"node dist/index.js","ingest":"node --import tsx scripts/ingest.ts","build:db":"node --import tsx scripts/build-db.ts","validate":"npm run lint && npm test && npm run test:contract","test:watch":"vitest","postinstall":"test -d dist || npm run build || true","drift:detect":"node --import tsx scripts/drift-detect.ts","test:contract":"vitest run __tests__/contract/","test:coverage":"vitest run --coverage","prepublishOnly":"npm run build"},"_npmUser":{"name":"ansvar","email":"jeffrey.von.rotz@ansvar.eu"},"overrides":{"ajv":"^8.18.0","undici":"^7.0.0","path-to-regexp":"^8.0.0"},"repository":{"url":"git+https://github.com/Ansvar-Systems/vietnamese-law-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Vietnamese law database covering Cybersecurity Law, Personal Data Protection Decree, Law on Information Technology, Enterprise Law, Law on E-Transactions, and Consumer Rights Protection with full-text search","directories":{},"_nodeVersion":"20.20.0","dependencies":{"@ansvar/mcp-sqlite":"^1.0.3","@modelcontextprotocol/sdk":"^1.25.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","vitest":"^3.0.0","typescript":"^5.9.3","@types/node":"^22.15.29","@vercel/node":"^5.6.4","better-sqlite3":"^12.6.2","@types/better-sqlite3":"^7.6.13"},"_npmOperationalInternal":{"tmp":"tmp/vietnamese-law-mcp_1.0.1_1771782023687_0.3709178211371287","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Ansvar MCP servers are now distributed as source from github.com/Ansvar-Systems/vietnamese-law-mcp under Apache 2.0. Self-hosting instructions: see the repo README. Hosted gateway: ansvar.eu"},"2.0.0":{"name":"@ansvar/vietnamese-law-mcp","version":"2.0.0","keywords":["mcp","model-context-protocol","vietnamese-law","cybersecurity-law","personal-data-protection","information-technology","enterprise-law","e-transactions","consumer-rights","legislation","legal","compliance","asean","ansvar"],"author":{"name":"Ansvar Systems","email":"hello@ansvar.eu"},"license":"Apache-2.0","_id":"@ansvar/vietnamese-law-mcp@2.0.0","maintainers":[{"name":"ansvar","email":"jeffrey.von.rotz@ansvar.eu"}],"homepage":"https://ansvar.eu","bugs":{"url":"https://github.com/Ansvar-Systems/vietnamese-law-mcp/issues"},"bin":{"vietnamese-law-mcp":"dist/index.js"},"dist":{"shasum":"b61159f58a4af4655efae1462e2ba866658ea688","tarball":"https://registry.npmjs.org/@ansvar/vietnamese-law-mcp/-/vietnamese-law-mcp-2.0.0.tgz","fileCount":125,"integrity":"sha512-/c9ubQP9xXc7wBGSuHezDNNEuNdKathKt+POImQsVnAjaduqxdctwCr/5dI4qtdYhHcTyeVoYT1SCT6AJOXwMg==","signatures":[{"sig":"MEUCIQC4sksKlHn9sQM5EFVg39mtCgv9ZzqBKO1pKDrk/5ihRgIgKDdOgH0IrJ7B/ICmpa7LG0/UYLYzR7WbFu7UdFWhN50=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ansvar%2fvietnamese-law-mcp@2.0.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":14576375},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"e89f64e679e6f5c2b74854afab2f83a1a54b61db","mcpName":"eu.ansvar/vietnamese-law-mcp","scripts":{"dev":"node --import tsx src/index.ts","lint":"tsc --noEmit","test":"vitest run","build":"tsc","start":"node dist/index.js","census":"node --import tsx scripts/census.ts","ingest":"node --import tsx scripts/ingest.ts","build:db":"node --import tsx scripts/build-db.ts","validate":"npm run lint && npm test && npm run test:contract","test:watch":"vitest","postinstall":"test -d dist || npm run build || true","drift:detect":"node --import tsx scripts/drift-detect.ts","check-updates":"node --import tsx scripts/check-updates.ts","test:contract":"vitest run __tests__/contract/","test:coverage":"vitest run --coverage","prepublishOnly":"npm run build"},"_npmUser":{"name":"ansvar","email":"jeffrey.von.rotz@ansvar.eu"},"overrides":{"ajv":"^8.18.0","undici":"^7.0.0","path-to-regexp":"^8.0.0"},"repository":{"url":"git+https://github.com/Ansvar-Systems/vietnamese-law-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Comprehensive Vietnamese law database: 93 laws covering Constitution, Civil/Penal Codes, Cybersecurity Law, Personal Data Protection, Enterprise Law, E-Transactions, and 80+ more statutes with full-text search","directories":{},"_nodeVersion":"20.20.0","dependencies":{"@ansvar/mcp-sqlite":"^1.0.3","@modelcontextprotocol/sdk":"^1.25.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","vitest":"^3.0.0","typescript":"^5.9.3","@types/node":"^22.15.29","@vercel/node":"^5.6.4","better-sqlite3":"^12.6.2","@types/better-sqlite3":"^7.6.13"},"_npmOperationalInternal":{"tmp":"tmp/vietnamese-law-mcp_2.0.0_1772104469204_0.043068474693672254","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Ansvar MCP servers are now distributed as source from github.com/Ansvar-Systems/vietnamese-law-mcp under Apache 2.0. Self-hosting instructions: see the repo README. Hosted gateway: ansvar.eu"}},"time":{"created":"2026-02-22T17:40:23.586Z","modified":"2026-05-02T05:50:04.320Z","1.0.1":"2026-02-22T17:40:23.926Z","2.0.0":"2026-02-26T11:14:29.532Z"},"bugs":{"url":"https://github.com/Ansvar-Systems/vietnamese-law-mcp/issues"},"author":{"name":"Ansvar Systems","email":"hello@ansvar.eu"},"license":"Apache-2.0","homepage":"https://ansvar.eu","keywords":["mcp","model-context-protocol","vietnamese-law","cybersecurity-law","personal-data-protection","information-technology","enterprise-law","e-transactions","consumer-rights","legislation","legal","compliance","asean","ansvar"],"repository":{"url":"git+https://github.com/Ansvar-Systems/vietnamese-law-mcp.git","type":"git"},"description":"Comprehensive Vietnamese law database: 93 laws covering Constitution, Civil/Penal Codes, Cybersecurity Law, Personal Data Protection, Enterprise Law, E-Transactions, and 80+ more statutes with full-text search","maintainers":[{"name":"ansvar","email":"jeffrey.von.rotz@ansvar.eu"}],"readme":"# Vietnamese Law MCP Server\n\n**The thuvienphapluat.vn alternative for the AI age.**\n\n[![npm version](https://badge.fury.io/js/@ansvar%2Fvietnamese-law-mcp.svg)](https://www.npmjs.com/package/@ansvar/vietnamese-law-mcp)\n[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io)\n[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![CI](https://github.com/Ansvar-Systems/vietnamese-law-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Ansvar-Systems/vietnamese-law-mcp/actions/workflows/ci.yml)\n[![Provisions](https://img.shields.io/badge/provisions-3%2C226-blue)]()\n\nQuery **93 Vietnamese laws** -- from the Cybersecurity Law and Personal Data Protection to the Civil Code, Penal Code, and Enterprise Law -- directly from Claude, Cursor, or any MCP-compatible client.\n\nIf you're building legal tech, compliance tools, or doing Vietnamese legal research, this is your verified reference database.\n\nBuilt by [Ansvar Systems](https://ansvar.eu)\n\n---\n\n## Why This Exists\n\nVietnamese legal research is scattered across thuvienphapluat.vn, vbpl.vn, vanban.chinhphu.vn, and luatvietnam.vn. Whether you're:\n- A **lawyer** validating citations in a brief or contract\n- A **compliance officer** checking cybersecurity or data protection requirements\n- A **legal tech developer** building tools on Vietnamese law\n- A **business** navigating enterprise law, investment, or tax regulations\n\n...you shouldn't need to navigate multiple portals in Vietnamese. Ask Claude. Get the exact provision. With context.\n\nThis MCP server makes Vietnamese law **searchable, cross-referenceable, and AI-readable**.\n\n---\n\n## Quick Start\n\n### Use Remotely (No Install Needed)\n\n> Connect directly to the hosted version -- zero dependencies, nothing to install.\n\n**Endpoint:** `https://vietnamese-law-mcp.vercel.app/mcp`\n\n| Client | How to Connect |\n|--------|---------------|\n| **Claude.ai** | Settings > Connectors > Add Integration > paste URL |\n| **Claude Code** | `claude mcp add vietnamese-law --transport http https://vietnamese-law-mcp.vercel.app/mcp` |\n| **Claude Desktop** | Add to config (see below) |\n| **GitHub Copilot** | Add to VS Code settings (see below) |\n\n**Claude Desktop** -- add to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"vietnamese-law\": {\n      \"type\": \"url\",\n      \"url\": \"https://vietnamese-law-mcp.vercel.app/mcp\"\n    }\n  }\n}\n```\n\n**GitHub Copilot** -- add to VS Code `settings.json`:\n\n```json\n{\n  \"github.copilot.chat.mcp.servers\": {\n    \"vietnamese-law\": {\n      \"type\": \"http\",\n      \"url\": \"https://vietnamese-law-mcp.vercel.app/mcp\"\n    }\n  }\n}\n```\n\n### Use Locally (npm)\n\n```bash\nnpx @ansvar/vietnamese-law-mcp\n```\n\n**Claude Desktop** -- add to `claude_desktop_config.json`:\n\n**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"vietnamese-law\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ansvar/vietnamese-law-mcp\"]\n    }\n  }\n}\n```\n\n---\n\n## What's Included\n\n| Category | Count | Details |\n|----------|-------|---------|\n| **Laws** | 93 documents | Constitution, 6 Codes, 85 Laws, 1 key Decree |\n| **Provisions** | 3,226 articles | Full-text searchable with FTS5 (unicode61 tokenizer) |\n| **Definitions** | 104 terms | Extracted from interpretation articles |\n| **Database Size** | ~14 MB | Optimized SQLite, portable |\n\n### Coverage by Category\n\n| Category | Key Laws | Articles |\n|----------|----------|----------|\n| **Constitution** | Hien phap 2013 | 120 |\n| **Civil Law** | Civil Code 2015 (689 arts), Civil Procedure Code 2015 (511 arts) | 1,196 |\n| **Criminal Law** | Penal Code 2015 (287 arts incl. cybercrime), Criminal Procedure Code 2015 (503 arts) | 790 |\n| **Cybersecurity & ICT** | Cybersecurity Law 2018, Network Security 2015, IT Law 2006, E-Transactions 2023, Data Law 2024, PDP Law 2025 | 238 |\n| **Labour** | Labour Code 2019 (220 arts), Employment 2013, Occupational Safety 2015 | 249 |\n| **Commerce & Enterprise** | Enterprise Law 2020, Investment 2020, Competition 2018, Consumer Rights 2023, Securities 2019 | 69 |\n| **Finance & Tax** | Tax Administration 2019, VAT 2024, CIT 2008, PIT 2007, AML 2022, Credit Institutions 2024 | 30 |\n| **Land & Construction** | Land Law 2024, Housing 2023, Construction 2014, Real Estate 2023 | 162 |\n| **Other** | Anti-Corruption, IP Law, Press Law, Education, Transport, Defence, and 30+ more | 491 |\n\n**Verified data only** -- all text is sourced from official thuvienphapluat.vn and vbpl.vn databases. Zero LLM-generated content.\n\n---\n\n## Example Queries\n\nOnce connected, just ask naturally:\n\n- *\"What does Article 26 of the Cybersecurity Law say about data localization?\"*\n- *\"What are the cybercrime penalties in Vietnam's Penal Code?\"*\n- *\"Search for provisions about 'du lieu ca nhan' (personal data)\"*\n- *\"What consumer data protection obligations exist under Vietnamese law?\"*\n- *\"What does Article 21 of the Constitution guarantee regarding privacy?\"*\n- *\"Find provisions about electronic signatures in the E-Transactions Law\"*\n- *\"What are the requirements for enterprise registration under the Enterprise Law?\"*\n\n---\n\n## Available Tools\n\n### Core Legal Research Tools (8)\n\n| Tool | Description |\n|------|-------------|\n| `search_legislation` | FTS5 search on 3,226 provisions with BM25 ranking (Vietnamese + English) |\n| `get_provision` | Retrieve specific article by law ID + article number |\n| `build_legal_stance` | Aggregate citations from multiple laws |\n| `format_citation` | Format citations per Vietnamese conventions |\n| `check_currency` | Check if law is in force, amended, or repealed |\n| `validate_citation` | Validate citation against database (zero-hallucination check) |\n| `get_eu_basis` | Get EU/international framework references |\n| `get_provision_eu_basis` | Get EU law references for specific provision |\n\n---\n\n## Regulatory Context\n\n- **Legal system:** Civil law with socialist legal traditions (French and Soviet influences)\n- **Cybersecurity authority:** Ministry of Public Security (MPS)\n- **IT/Telecoms regulator:** Ministry of Information and Communications (MIC)\n- **Data protection:** Decree 13/2023/ND-CP is the current primary PDP regulation; standalone Law on Personal Data Protection (No. 91/2025/QH15) takes effect 2026-01-01\n- **Data localization:** Cybersecurity Law 2018 requires storage of Vietnamese user data in Vietnam\n- **Cross-border transfers:** Impact assessment + government registration required\n- **Language:** Vietnamese (tieng Viet) is the legally binding language; English translations are unofficial\n- **ASEAN member:** Participates in ASEAN Framework on Digital Data Governance\n- **Legislation numbering:** Type + Number/Year/Issuing body (e.g., 24/2018/QH14 = Law 24, 2018, 14th National Assembly)\n\n---\n\n## Data Sources & Freshness\n\n| Source | Authority | Method | License |\n|--------|-----------|--------|---------|\n| [Thu Vien Phap Luat](https://thuvienphapluat.vn) | LawNet | HTML scrape | Open Access |\n| [VBPL](https://vbpl.vn) | Ministry of Justice | Cross-reference | Government Open Data |\n\n> Full provenance metadata: [`sources.yml`](./sources.yml)\n\n---\n\n## Development\n\n### Setup\n\n```bash\ngit clone https://github.com/Ansvar-Systems/vietnamese-law-mcp\ncd vietnamese-law-mcp\nnpm install\nnpm run build\nnpm test\n```\n\n### Data Pipeline\n\n```bash\nnpm run census                        # Generate full law census (data/census.json)\nnpm run ingest                        # Fetch + parse all laws from census\nnpm run ingest -- --resume            # Resume interrupted ingestion\nnpm run ingest -- --limit 5           # Test with 5 laws\nnpm run ingest -- --skip-fetch        # Reparse cached HTML\nnpm run build:db                      # Build SQLite database from seeds\nnpm run check-updates                 # Check for legislative changes\n```\n\n### Running Locally\n\n```bash\nnpm run dev                                       # Start MCP server\nnpx @anthropic/mcp-inspector node dist/index.js   # Test with MCP Inspector\n```\n\n### Contract Tests\n\n12 golden contract tests covering:\n- 5 article retrieval tests (Constitution Art 21, Cybersecurity Art 1, Penal Code Art 285, Civil Code Art 1, PDP Decree Art 1)\n- 3 search tests (du lieu ca nhan, an ninh mang, doanh nghiep)\n- 1 citation roundtrip test (thuvienphapluat.vn URL)\n- 1 cross-reference test (Labour Code Art 1)\n- 2 negative tests (non-existent law, malformed article)\n\n```bash\nnpm run test:contract\n```\n\n---\n\n## Vietnamese Legislation Numbering\n\n| Format | Example | Meaning |\n|--------|---------|---------|\n| Law (Luat) | 24/2018/QH14 | Law No. 24, Year 2018, 14th National Assembly |\n| Decree (Nghi dinh) | 13/2023/ND-CP | Decree No. 13, Year 2023, Government |\n| Circular (Thong tu) | XX/YYYY/TT-BCA | Circular from Ministry of Public Security |\n| Decision (Quyet dinh) | XX/YYYY/QD-TTg | Decision of the Prime Minister |\n| Code (Bo luat) | 91/2015/QH13 | Civil Code No. 91, Year 2015, 13th National Assembly |\n\n---\n\n## Important Disclaimers\n\n### Legal Advice\n\n> **THIS TOOL IS NOT LEGAL ADVICE**\n>\n> Text is sourced from official Vietnamese legal databases. However:\n> - This is a **research tool**, not a substitute for professional legal counsel\n> - **Vietnamese is the legally binding language**; English content is unofficial\n> - **Verify critical citations** against primary sources for court filings\n> - Some laws with newer URL patterns have metadata only (no article text)\n\n**Before using professionally, read:** [DISCLAIMER.md](DISCLAIMER.md) | [PRIVACY.md](PRIVACY.md)\n\n---\n\n## Related Projects: Complete Compliance Suite\n\n### [@ansvar/eu-regulations-mcp](https://github.com/Ansvar-Systems/EU_compliance_MCP)\n**Query 49 EU regulations** -- GDPR, AI Act, DORA, NIS2, and more. `npx @ansvar/eu-regulations-mcp`\n\n### [@ansvar/us-regulations-mcp](https://github.com/Ansvar-Systems/US_Compliance_MCP)\n**Query US federal and state compliance laws** -- HIPAA, CCPA, SOX, and more. `npx @ansvar/us-regulations-mcp`\n\n### [@ansvar/security-controls-mcp](https://github.com/Ansvar-Systems/Security-Controls-MCP)\n**Query 261 security frameworks and 1,451 SCF controls.** `npx @ansvar/security-controls-mcp`\n\n---\n\n## Security\n\nSee [SECURITY.md](SECURITY.md) for vulnerability disclosure policy.\n\nReport data errors: [Open an issue](https://github.com/Ansvar-Systems/vietnamese-law-mcp/issues/new?template=data-error.md)\n\n---\n\n## License\n\nApache License 2.0. See [LICENSE](./LICENSE) for details.\n\n### Data Licenses\n\n- **Vietnamese legislation:** Government work product (public domain under Vietnamese law)\n- **thuvienphapluat.vn:** Open Access legal database\n- **vbpl.vn:** Government Open Data (Ministry of Justice)\n\n---\n\n## About Ansvar Systems\n\nWe build AI-accelerated compliance and legal research tools. This MCP server makes Vietnamese law searchable and AI-readable -- because navigating 93 laws across multiple Vietnamese-language portals shouldn't require a law degree.\n\n**[ansvar.eu](https://ansvar.eu)**\n\n---\n\n<p align=\"center\">\n  <sub>Built with care by Ansvar Systems</sub>\n</p>\n","readmeFilename":"README.md"}