Japan Utils
Wraps a handful of Python libraries (jpholiday, posuto, pykakasi, jaconv, namedivider-python) into MCP tools for Japan-specific operations that LLMs routinely hallucinate. You get era-to-Gregorian conversion (令和8年 to 2026 and back), kanji-to-romaji using Hepburn rules, postal code lookups against Japan Post's KEN_ALL dataset, national holiday checks, kana conversion between hiragana/katakana/half-width forms, full-width/half-width ASCII normalization, and statistical Japanese name splitting. Runs via uvx with no install hassle. Useful when you're building agents that handle Japanese addresses, dates, or text normalization and need deterministic answers instead of plausible-sounding garbage. Covers Meiji through Reiwa for era calculations, national holidays only.
- tools
- 9
- transport
- STDIO
- last updated
- May 3, 2026
Tools
9 toolsPublic tool metadata for what this MCP can expose to an agent.
era_to_western令和8年 / R8 / Reiwa 8 / 令和元年 → Gregorian year + era metadata
令和8年 / R8 / Reiwa 8 / 令和元年 → Gregorian year + era metadata
No parameter schema in public metadata yet.
western_to_era2026 → era kanji (令和), English (Reiwa), year-of-era (8), formatted strings
2026 → era kanji (令和), English (Reiwa), year-of-era (8), formatted strings
No parameter schema in public metadata yet.
kanji_to_romajiMixed Japanese text → Hepburn romaji + hiragana reading
Mixed Japanese text → Hepburn romaji + hiragana reading
No parameter schema in public metadata yet.
lookup_postal_code7-digit JP postal code → prefecture / city / area, with kana readings
7-digit JP postal code → prefecture / city / area, with kana readings
No parameter schema in public metadata yet.
is_holidayDate string → is it a national holiday? + Japanese name + weekday
Date string → is it a national holiday? + Japanese name + weekday
No parameter schema in public metadata yet.
list_holidaysYear → all national holidays for that year
Year → all national holidays for that year
No parameter schema in public metadata yet.
convert_kanahiragana ↔ katakana ↔ half-width katakana, any direction
hiragana ↔ katakana ↔ half-width katakana, any direction
No parameter schema in public metadata yet.
normalize_widthFull-width ↔ half-width for ASCII, digits, kana (with per-category control)
Full-width ↔ half-width for ASCII, digits, kana (with per-category control)
No parameter schema in public metadata yet.
split_japanese_nameJapanese full name → surname + given name (statistical model with confidence)
Japanese full name → surname + given name (statistical model with confidence)
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
japan-utils-mcp
MCP server exposing Japan-specific utilities to AI agents (Claude, Cursor, Cline, Continue, etc.). Hand your agent the small bag of JP-specific functions every Japan-related task needs but no generic LLM gets right reliably:
- 🗓️ Era ↔ Western year —
令和8年↔2026 - 🔤 Kanji → Hepburn romaji —
山田太郎→yamada tarou - 📮 Postal code lookup —
150-0001→東京都 渋谷区 神宮前 - 🎌 National holiday calendar — is
2026-05-03a holiday? what about all of 2026? - 🅰️ Kana conversion — hiragana ↔ katakana ↔ half-width katakana
- 📏 Width normalization — full-width (全角) ↔ half-width (半角) for ASCII, digits, kana
- 👤 Name splitting —
山田太郎→ surname山田+ given太郎(statistical model)
Details
- Repository
- github.com/vivek081166/japan-utils-mcp
- Package
japan-utils-mcp- Transport
- STDIO
- Registry
- MCP registry, active