What is Japan Utils Mcp?
Japan Utils Mcp is an MCP (Model Context Protocol) server that exposes Japan-specific utilities to AI agents like Claude, Cursor, Cline, and Continue. It provides deterministic tools for tasks such as Japanese era-to-western year conversion, kanji-to-romaji transliteration, postal code lookup, national holiday queries, kana conversion, width normalization, and Japanese name splitting. It is built on well-maintained Japanese libraries (jpholiday, posuto, pykakasi, jaconv, namedivider-python) and wrapped as MCP tools for reliable, non-hallucinated answers.
How to use Japan Utils Mcp?
Install and run via uvx japan-utils-mcp (recommended, no install needed). Alternatively, clone the source repository, sync dependencies with uv sync, and run uv run japan-utils-mcp. Configure the server in your MCP client (e.g., Claude Desktop, Claude Code, Cursor) by adding a JSON entry with the uvx command and japan-utils-mcp argument to the client’s MCP configuration file.
Key features of Japan Utils Mcp
- Era to western year conversion (Meiji through Reiwa)
- Kanji to Hepburn romaji conversion
- Japanese postal code lookup with address and kana readings
- National holiday calendar (annual listing and single-date check)
- Hiragana ↔ katakana ↔ half-width katakana conversion
- Full-width to half-width normalization for ASCII, digits, and kana
- Statistical Japanese name splitting into surname and given name
- All tools return structured JSON for deterministic answers
Use cases of Japan Utils Mcp
- Convert a Japanese era year (e.g., 令和8年) to its Gregorian equivalent (2026)
- Look up the address for a 7-digit postal code (e.g., 150-0001 → 東京都 渋谷区 神宮前)
- Transcribe a personal name like 山田太郎 into Hepburn romaji (yamada tarou)
- Verify whether a specific date is a Japanese national holiday (e.g., 2026-05-03 → 憲法記念日)
- Normalize mixed-width text (e.g., full-width ABC to half-width ABC)
评论