{"_id":"@ansvar/japan-law-mcp","_rev":"2-60d876cd698ee18019ed23e935ab322e","name":"@ansvar/japan-law-mcp","dist-tags":{"latest":"1.1.1"},"versions":{"1.1.1":{"name":"@ansvar/japan-law-mcp","version":"1.1.1","keywords":["mcp","model-context-protocol","ai","claude","japan-law","appi","personal-information","cybersecurity","telecommunications","companies-act","unauthorized-access","my-number","japan","legal","compliance","ansvar"],"author":{"name":"Ansvar Systems AB","email":"hello@ansvar.ai"},"license":"Apache-2.0","_id":"@ansvar/japan-law-mcp@1.1.1","maintainers":[{"name":"ansvar","email":"jeffrey.von.rotz@ansvar.eu"}],"homepage":"https://github.com/Ansvar-Systems/japan-law-mcp#readme","bugs":{"url":"https://github.com/Ansvar-Systems/japan-law-mcp/issues"},"bin":{"japan-law-mcp":"dist/index.js"},"dist":{"shasum":"eb4a823b3646f819db4fbef23214cbbab54d6678","tarball":"https://registry.npmjs.org/@ansvar/japan-law-mcp/-/japan-law-mcp-1.1.1.tgz","fileCount":121,"integrity":"sha512-DvPeICNtwIyc+AJdpjE/KC6RrdlC+3Dih2K26bTN3BWIMhQH5LzH8zsTG9CZsinn552jrNPoB1+0pYT0JguPVA==","signatures":[{"sig":"MEUCIQDG9CoJ2LNQutplGp31Pd/eHmaZpoPVwY8g/v9ZWK+SkAIgNwOsGBU4Jc2Ktx+Ccoex38Mwn8Huo+6m2aJk6mlug/g=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ansvar%2fjapan-law-mcp@1.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":4571470},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"36f830564b62c2a0d57746732e930162f07e5210","mcpName":"eu.ansvar/japan-law-mcp","scripts":{"dev":"node --import tsx src/index.ts","lint":"tsc --noEmit","test":"vitest run","build":"tsc","start":"node dist/index.js","health":"curl -s http://localhost:3000/health | jq .","ingest":"node --import tsx scripts/ingest.ts","build:db":"node --import tsx scripts/build-db.ts","validate":"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","build:db:free":"node --import tsx scripts/build-db-free.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/japan-law-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Japanese law database covering personal information protection (APPI), cybersecurity, telecommunications, corporate law, and unauthorized access legislation 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":"^4.0.18","typescript":"^5.9.3","@types/node":"^22.15.29","@vercel/node":"^5.6.4","better-sqlite3":"^12.6.2","fast-xml-parser":"^5.3.5","@vitest/coverage-v8":"^4.0.18","@types/better-sqlite3":"^7.6.13"},"_npmOperationalInternal":{"tmp":"tmp/japan-law-mcp_1.1.1_1771778406578_0.7621927519855962","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Ansvar MCP servers are now distributed as source from github.com/Ansvar-Systems/japan-law-mcp under Apache 2.0. Self-hosting instructions: see the repo README. Hosted gateway: ansvar.eu"}},"time":{"created":"2026-02-22T16:40:06.483Z","modified":"2026-05-02T05:47:30.720Z","1.1.1":"2026-02-22T16:40:06.765Z"},"bugs":{"url":"https://github.com/Ansvar-Systems/japan-law-mcp/issues"},"author":{"name":"Ansvar Systems AB","email":"hello@ansvar.ai"},"license":"Apache-2.0","homepage":"https://github.com/Ansvar-Systems/japan-law-mcp#readme","keywords":["mcp","model-context-protocol","ai","claude","japan-law","appi","personal-information","cybersecurity","telecommunications","companies-act","unauthorized-access","my-number","japan","legal","compliance","ansvar"],"repository":{"url":"git+https://github.com/Ansvar-Systems/japan-law-mcp.git","type":"git"},"description":"Japanese law database covering personal information protection (APPI), cybersecurity, telecommunications, corporate law, and unauthorized access legislation with full-text search","maintainers":[{"name":"ansvar","email":"jeffrey.von.rotz@ansvar.eu"}],"readme":"# Japanese Law MCP Server\n\n**The e-Gov Laws alternative for the AI age.**\n\n[![npm version](https://badge.fury.io/js/%40ansvar/japan-law-mcp.svg)](https://www.npmjs.com/package/@ansvar/japan-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[![GitHub stars](https://img.shields.io/github/stars/Ansvar-Systems/Japan-law-mcp?style=social)](https://github.com/Ansvar-Systems/Japan-law-mcp)\n[![CI](https://github.com/Ansvar-Systems/Japan-law-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Ansvar-Systems/Japan-law-mcp/actions/workflows/ci.yml)\n\nQuery **Japanese legislation** -- covering data protection, cybersecurity, corporate law, and more -- directly from Claude, Cursor, or any MCP-compatible client.\n\nIf you're building legal tech, compliance tools, or doing Japanese legal research, this is your verified reference database.\n\nBuilt by [Ansvar Systems](https://ansvar.eu) -- Stockholm, Sweden\n\n---\n\n## Why This Exists\n\nJapanese legal research is scattered across official government databases, commercial legal platforms, and institutional archives. Whether you're:\n- A **lawyer** validating citations in a brief or contract\n- A **compliance officer** checking if a statute is still in force\n- A **legal tech developer** building tools on Japanese law\n- A **researcher** tracing legislative history\n\n...you shouldn't need dozens of browser tabs and manual PDF cross-referencing. Ask Claude. Get the exact provision. With context.\n\nThis MCP server makes Japanese 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://japan-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 japan-law --transport http https://japan-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    \"japan-law\": {\n      \"type\": \"url\",\n      \"url\": \"https://japan-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    \"japan-law\": {\n      \"type\": \"http\",\n      \"url\": \"https://japan-law-mcp.vercel.app/mcp\"\n    }\n  }\n}\n```\n\n### Use Locally (npm)\n\n```bash\nnpx @ansvar/japan-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    \"japan-law\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ansvar/japan-law-mcp\"]\n    }\n  }\n}\n```\n\n**Cursor / VS Code:**\n\n```json\n{\n  \"mcp.servers\": {\n    \"japan-law\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ansvar/japan-law-mcp\"]\n    }\n  }\n}\n```\n\n---\n\n## Example Queries\n\nOnce connected, just ask naturally:\n\n- *\"What does the Japanese data protection law say about consent?\"*\n- *\"Search for cybersecurity requirements in Japanese legislation\"*\n- *\"Is this statute still in force?\"*\n- *\"Find provisions about personal data in Japanese law\"*\n- *\"What EU directives does this Japanese law implement?\"*\n- *\"Which Japanese laws implement the GDPR?\"*\n- *\"Validate this legal citation\"*\n- *\"Build a legal stance on data breach notification requirements\"*\n\n---\n\n## Laws Covered\n\n| Law | Japanese Name | Act Number | Key Topic |\n|-----|--------------|------------|-----------|\n| **Act on Protection of Personal Information (APPI)** | 個人情報の保護に関する法律 | Act No. 57 of 2003 (amended 2020) | Personal data protection (EU adequacy) |\n| **Cybersecurity Basic Act** | サイバーセキュリティ基本法 | Act No. 104 of 2014 | National cybersecurity framework |\n| **Telecommunications Business Act** | 電気通信事業法 | Act No. 86 of 1984 | Telecom regulation, communications secrecy |\n| **Companies Act** | 会社法 | Act No. 86 of 2005 | Corporate governance, shareholder rights |\n| **Act on Prohibition of Unauthorized Computer Access** | 不正アクセス行為の禁止等に関する法律 | Act No. 128 of 1999 | Anti-hacking, unauthorized access |\n| **My Number Act** | 行政手続における特定の個人を識別するための番号の利用等に関する法律 | Act No. 27 of 2013 | National ID number system |\n| **Constitution (selected provisions)** | 日本国憲法 | 1946 | Fundamental rights, Article 13 (privacy basis) |\n\nAdditionally includes key PPC guidelines and supplementary materials:\n\n- APPI Guidelines (General Rules, Cross-Border Transfer, etc.)\n- PPC Q&A on APPI interpretation\n- EU-Japan Adequacy Decision supplementary rules\n\n---\n\n## Deployment Tiers\n\n| Tier | Content | Database Size | Platform |\n|------|---------|---------------|----------|\n| **Free** | All major statutes + English translations + EU cross-references | ~100-150 MB | Vercel (bundled) or local |\n| **Professional** | + Cabinet orders + ministerial ordinances + PPC guidelines + full regulatory corpus | ~500 MB-800 MB | Azure Container Apps / Docker / local |\n\n### Deployment Strategy: MEDIUM - Dual Tier, Bundled Free\n\nThe free-tier database containing major statutes and English translations is estimated at 100-150 MB, within the Vercel 250 MB bundle limit. The free-tier database is bundled directly with the Vercel deployment. The professional tier with full cabinet orders, ministerial ordinances, and PPC guidelines requires local Docker or Azure Container Apps deployment.\n\n### Capability Detection\n\nBoth tiers use the same codebase. At startup, the server detects available SQLite tables and gates tools accordingly:\n\n```\nFree tier:     core_legislation, eu_references, english_translations\nProfessional:  core_legislation, eu_references, english_translations, cabinet_orders, ministerial_ordinances, ppc_guidelines\n```\n\nTools that require professional capabilities return an upgrade message on the free tier.\n\n---\n\n## Database Size Estimates\n\n| Component | Estimated Size | Notes |\n|-----------|---------------|-------|\n| Major statutes (laws / 法律) | ~40-50 MB | ~200 key statutes, full Japanese text |\n| English translations (JLT) | ~30-40 MB | Official MOJ translations of major laws |\n| EU cross-references | ~5-10 MB | APPI-GDPR adequacy mapping tables |\n| FTS5 indexes | ~30-50 MB | Full-text search indexes for Japanese text (ICU tokenization) |\n| **Free tier total** | **~100-150 MB** | |\n| Cabinet orders (政令) | ~100-200 MB | Government orders implementing statutes |\n| Ministerial ordinances (省令) | ~150-250 MB | Ministry-level regulations |\n| PPC guidelines | ~20-50 MB | APPI interpretive guidelines |\n| **Professional tier total** | **~500 MB-800 MB** | |\n\n---\n\n## Language Support\n\nThe primary language is **Japanese (ja)**, which is the sole legally binding version. Official English translations are available from the Japanese Law Translation portal (japaneselawtranslation.go.jp), maintained by the Ministry of Justice. These translations are explicitly marked as reference translations and are not legally authoritative.\n\nThe search tool supports queries in both Japanese and English, with Japanese queries using ICU-based tokenization for proper morphological analysis.\n\n---\n\n## Available Tools (13)\n\n### Core Legal Research Tools (8)\n\n| Tool | Description |\n|------|-------------|\n| `search_legislation` | FTS5 full-text search across all provisions with BM25 ranking |\n| `get_provision` | Retrieve specific provision by statute + chapter/section |\n| `check_currency` | Check if statute is in force, amended, or repealed |\n| `validate_citation` | Validate citation against database (zero-hallucination check) |\n| `build_legal_stance` | Aggregate citations from statutes for a legal topic |\n| `format_citation` | Format citations per Japanese conventions (full/short/pinpoint) |\n| `list_sources` | List all available statutes with metadata |\n| `about` | Server info, capabilities, and coverage summary |\n\n### EU/International Law Integration Tools (5)\n\n| Tool | Description |\n|------|-------------|\n| `get_eu_basis` | Get EU directives/regulations for Japanese statute |\n| `get_japanese_implementations` | Find Japanese laws implementing EU act |\n| `search_eu_implementations` | Search EU documents with Japanese implementation counts |\n| `get_provision_eu_basis` | Get EU law references for specific provision |\n| `validate_eu_compliance` | Check implementation status of EU directives |\n\n---\n\n## Why This Works\n\n**Verbatim Source Text (No LLM Processing):**\n- All statute text is ingested from official Japanese government sources\n- Provisions are returned **unchanged** from SQLite FTS5 database rows\n- Zero LLM summarization or paraphrasing -- the database contains regulation text, not AI interpretations\n\n**Smart Context Management:**\n- Search returns ranked provisions with BM25 scoring (safe for context)\n- Provision retrieval gives exact text by statute identifier + chapter/section\n- Cross-references help navigate without loading everything at once\n\n**Technical Architecture:**\n```\nOfficial Sources --> Parse --> SQLite --> FTS5 snippet() --> MCP response\n                     ^                       ^\n              Provision parser         Verbatim database query\n```\n\n### Traditional Research vs. This MCP\n\n| Traditional Approach | This MCP Server |\n|---------------------|-----------------|\n| Search official databases by statute number | Search by plain language |\n| Navigate multi-chapter statutes manually | Get the exact provision with context |\n| Manual cross-referencing between laws | `build_legal_stance` aggregates across sources |\n| \"Is this statute still in force?\" --> check manually | `check_currency` tool --> answer in seconds |\n| Find EU basis --> dig through EUR-Lex | `get_eu_basis` --> linked EU directives instantly |\n| No API, no integration | MCP protocol --> AI-native |\n\n---\n\n## Data Sources & Freshness\n\nAll content is sourced from authoritative Japanese legal databases:\n\n- **[e-Gov Laws](https://elaws.e-gov.go.jp)** -- Official Japanese government legal database\n\n**Verified data only** -- every citation is validated against official sources. Zero LLM-generated content.\n\n---\n\n## Security\n\nThis project uses multiple layers of automated security scanning:\n\n| Scanner | What It Does | Schedule |\n|---------|-------------|----------|\n| **CodeQL** | Static analysis for security vulnerabilities | Weekly + PRs |\n| **Semgrep** | SAST scanning (OWASP top 10, secrets, TypeScript) | Every push |\n| **Gitleaks** | Secret detection across git history | Every push |\n| **Trivy** | CVE scanning on filesystem and npm dependencies | Daily |\n| **Socket.dev** | Supply chain attack detection | PRs |\n| **Dependabot** | Automated dependency updates | Weekly |\n\nSee [SECURITY.md](SECURITY.md) for the full policy and vulnerability reporting.\n\n---\n\n## Important Disclaimers\n\n### Legal Advice\n\n> **THIS TOOL IS NOT LEGAL ADVICE**\n>\n> Statute text is sourced from official Japanese government publications. However:\n> - This is a **research tool**, not a substitute for professional legal counsel\n> - **Court case coverage is limited** -- do not rely solely on this for case law research\n> - **Verify critical citations** against primary sources for court filings\n> - **EU cross-references** are extracted from statute text, not EUR-Lex full text\n\n**Before using professionally, read:** [DISCLAIMER.md](DISCLAIMER.md) | [SECURITY.md](SECURITY.md)\n\n### Client Confidentiality\n\nQueries go through the Claude API. For privileged or confidential matters, use on-premise deployment.\n\n---\n\n## Development\n\n### Setup\n\n```bash\ngit clone https://github.com/Ansvar-Systems/Japan-law-mcp\ncd Japan-law-mcp\nnpm install\nnpm run build\nnpm test\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---\n\n## Related Projects: Complete Compliance Suite\n\nThis server is part of **Ansvar's Compliance Suite** -- MCP servers that work together for end-to-end compliance coverage:\n\n### [@ansvar/eu-regulations-mcp](https://github.com/Ansvar-Systems/EU_compliance_MCP)\n**Query 49 EU regulations directly from Claude** -- GDPR, AI Act, DORA, NIS2, MiFID II, eIDAS, and more. Full regulatory text with article-level search. `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, GLBA, FERPA, 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** -- ISO 27001, NIST CSF, SOC 2, CIS Controls, SCF, and more. `npx @ansvar/security-controls-mcp`\n\n### [@ansvar/automotive-cybersecurity-mcp](https://github.com/Ansvar-Systems/Automotive-MCP)\n**Query UNECE R155/R156 and ISO 21434** -- Automotive cybersecurity compliance. `npx @ansvar/automotive-cybersecurity-mcp`\n\n**30+ national law MCPs** covering Australia, Brazil, Canada, China, Denmark, Finland, France, Germany, Ghana, Iceland, India, Ireland, Israel, Italy, Japan, Kenya, Netherlands, Nigeria, Norway, Singapore, Slovenia, South Korea, Sweden, Switzerland, Thailand, UAE, UK, and more.\n\n---\n\n## Contributing\n\nContributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\nPriority areas:\n- Court case law expansion\n- EU cross-reference improvements\n- Historical statute versions and amendment tracking\n- Additional statutory instruments and regulations\n\n---\n\n## Roadmap\n\n- [x] Core statute database with FTS5 search\n- [x] EU/international law cross-references\n- [x] Vercel Streamable HTTP deployment\n- [x] npm package publication\n- [ ] Court case law expansion\n- [ ] Historical statute versions (amendment tracking)\n- [ ] Preparatory works / explanatory memoranda\n- [ ] Lower court and tribunal decisions\n\n---\n\n## Citation\n\nIf you use this MCP server in academic research:\n\n```bibtex\n@software{japan_law_mcp_2025,\n  author = {Ansvar Systems AB},\n  title = {Japanese Law MCP Server: AI-Powered Legal Research Tool},\n  year = {2025},\n  url = {https://github.com/Ansvar-Systems/Japan-law-mcp},\n  note = {Japanese legal database with full-text search and EU cross-references}\n}\n```\n\n---\n\n## License\n\nApache License 2.0. See [LICENSE](./LICENSE) for details.\n\n### Data Licenses\n\n- **Statutes & Legislation:** Japanese Government (public domain)\n- **EU Metadata:** EUR-Lex (EU public domain)\n\n---\n\n## About Ansvar Systems\n\nWe build AI-accelerated compliance and legal research tools for the global market. This MCP server started as our internal reference tool -- turns out everyone building compliance tools has the same research frustrations.\n\nSo we're open-sourcing it.\n\n**[ansvar.eu](https://ansvar.eu)** -- Stockholm, Sweden\n\n---\n\n<p align=\"center\">\n  <sub>Built with care in Stockholm, Sweden</sub>\n</p>\n","readmeFilename":"README.md"}