Japan Utils Mcp
Japan-specific utilities for AI agents — era ↔ Western year conversion, kanji-to-romaji, postal code lookup, holidays, kana conversion, name splitting. 9 tools, MIT, install via uvx.
Overview
MCP server exposing Japan-specific utilities to AI agents. Hand any Claude/Cursor/Cline agent the small bag of JP functions every Japan-related task needs but generic LLMs hallucinate on.
Why this exists
Generic LLMs are unreliable on JP-specific data:
- "What year is 令和8年?" — often wrong
- "Convert 山田太郎 to romaji" — gets the surname wrong half the time
- "What's the address for postal code 150-0001?" — fabricates plausible-looking nonsense
- "Is May 3rd a Japanese holiday?" — guesses
This MCP gives them deterministic answers backed by well-maintained Python libraries (jpholiday, posuto, pykakasi, jaconv, namedivider-python).
9 tools
era_to_western—令和8年/R8/Reiwa 8→ 2026western_to_era— 2026 → 令和8年 (with kanji + English + short forms)kanji_to_romaji— Hepburn romaji + hiragana for any Japanese textlookup_postal_code— 7-digit 郵便番号 → prefecture / city / area + kanais_holiday— date → is national holiday + JP name + weekdaylist_holidays— year → all 国民の祝日convert_kana— hiragana ↔ katakana ↔ half-width katakananormalize_width— full-width (全角) ↔ half-width (半角), per-category controlsplit_japanese_name— full name → surname + given (statistical model with confidence)
Install
uvx japan-utils-mcp
PyPI: https://pypi.org/project/japan-utils-mcp/
Configuration (Claude Desktop)
{
"mcpServers": {
"japan-utils": {
"command": "uvx",
"args": ["japan-utils-mcp"]
}
}
}
MIT licensed. Python 3.13+. Runs locally over stdio.
Server Config
{
"mcpServers": {
"japan-utils": {
"command": "uvx",
"args": [
"japan-utils-mcp"
]
}
}
}Project Info
Created At
a month agoUpdated At
a month agoAuthor Name
vivek081166Star
-Language
-License
-Recommend Servers
View AllTest
@modelcontextprotocol
test
6 months ago
Clarik Mcp Server
@Mikerichardmail
2 days ago
AppSumo Docs MCP
@5h0ov
11 hours ago
Amap Maps
@amap
高德地图官方 MCP Server
a year ago