jpzip MCP server
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@jpzip MCP server Look up zip code 100-0001"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-server-jpzip
日本の郵便番号を Claude / 任意の MCP クライアントから引ける Model Context Protocol サーバー。
jpzip.nadai.dev(Cloudflare Pages 配信の静的データ)を背後にもつ、stateless な stdio サーバー。
データ仕様:
jpzip/spec元データ: 日本郵便 KEN_ALL / KEN_ALL_ROME(月次更新追従)
インストール (Claude Code)
claude mcp add jpzip -- npx -y @jpzip/mcp-server-jpzipClaude Desktop など mcp.json を直接編集する場合:
{
"mcpServers": {
"jpzip": {
"command": "npx",
"args": ["-y", "@jpzip/mcp-server-jpzip"]
}
}
}Related MCP server: mcp-server-zipcode-jp
提供 Tool
Tool | 用途 |
| 郵便番号 → 住所(漢字/カナ/ローマ字 + JIS/総務省コード) |
| 住所文字列 → 郵便番号候補(漢字/カナ/ローマ字横断、空白無視の部分一致) |
| 都道府県名 → 市区町村一覧(総務省コード付き) |
| データバージョン・件数・生成時刻 |
動作モデル
lookup_zipcodeは対応する 3 桁 prefix(数十KB)のみを CDN から取得し、メモリにキャッシュする。search_by_address/list_cities_in_prefectureは初回呼び出し時に全件(約 25MB)を CDN から取得しメモリに保持する。同一 MCP プロセス内の以降の呼び出しは即時。永続キャッシュは持たない(stateless)。Claude の再起動で in-memory データは破棄され、次回必要になった時に再取得する。
既知の制約
駅・路線・事業所情報は jpzip データセットに含まれない(郵便番号⇄住所のみ)。
検索クエリは 1 言語(漢字 / カナ / ローマ字)内での連続部分一致のみ対応。例えば「Yokohama Honcho」(ローマ字で中区を飛ばす)はマッチしない。
ライセンス
MIT(コード) / 配信データは Public Domain 相当(日本郵便)。
Available Tools
4 toolsget_metadataA
Return the jpzip dataset metadata: data version (YYYY-MM), generated timestamp, total entry count, and per-prefecture counts. Useful for confirming the dataset is current.
Inputs: no named parameters.
list_cities_in_prefectureA
List all municipalities (city / ward / town / village) in a Japanese prefecture, with their Soumu city codes. Prefecture name accepts kanji, katakana, or romaji. Shares the same in-memory dataset as search_by_address.
Inputs: prefecture (required).
lookup_zipcodeA
Look up the Japanese address for a 7-digit postal code (郵便番号). Returns prefecture, city, and town(s) in kanji, katakana, and romaji, plus the JIS prefecture code and Soumu city code. Hyphens in the input are allowed.
Inputs: zipcode (required).
search_by_addressA
Search for postal codes by free-text address query. Matches against prefecture, city, and town in kanji, katakana, or romaji (case-insensitive substring match, whitespace ignored). First call in a session downloads the full dataset (~25MB) into memory; subsequent calls within the same session are instant.
Inputs: query (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: metadata retrieval, city listing, zip code lookup, and address search. No overlap or ambiguity.
All tool names follow a consistent verb_noun pattern using snake_case (e.g., get_metadata, list_cities_in_prefecture), making them predictable and easy to understand.
Four tools is appropriate for this domain, covering essential operations without being too sparse or excessive. Each tool earns its place.
The tool set covers all primary use cases for a zip code dataset: metadata, city listing, lookup by code, and free-text search. No obvious gaps.
Related MCP Connectors
Normalize and romanize Japanese addresses, look up postal codes, count Japanese business days.
Resolve Japanese 〒 postcodes to prefecture, city and town.
日本の住所⇄郵便番号を変換。表記ゆれも吸収。Japan address ⇄ postal code, handles messy input. Free tier, no API key.
Normalize and verify Japanese postal addresses into structured fields for agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides Japanese postal code to address lookup functionality that can be integrated with AI assistants and other MCP clients.3MIT
- AlicenseBqualityDmaintenanceEnables searching Japanese addresses by 7-digit zip code using the zipcloud API.1ISC
- AlicenseNot gradedqualityDmaintenanceJapanese postal code ⇄ address lookup with bundled official data — fully offline, no API key.MIT
- AlicenseAqualityDmaintenanceNormalizes and verifies Japanese postal addresses, splitting messy strings into structured fields with geolocation and verification.1MIT