Skip to main content
Glama
jpzip MCP server

jpzip MCP server

Official
by jpzip

mcp-server-jpzip

日本の郵便番号を Claude / 任意の MCP クライアントから引ける Model Context Protocol サーバー。jpzip.nadai.dev(Cloudflare Pages 配信の静的データ)を背後にもつ、stateless な stdio サーバー。

インストール (Claude Code)

claude mcp add jpzip -- npx -y @jpzip/mcp-server-jpzip

Claude Desktop など mcp.json を直接編集する場合:

{
  "mcpServers": {
    "jpzip": {
      "command": "npx",
      "args": ["-y", "@jpzip/mcp-server-jpzip"]
    }
  }
}

Related MCP server: mcp-server-zipcode-jp

提供 Tool

Tool

用途

lookup_zipcode(zipcode)

郵便番号 → 住所(漢字/カナ/ローマ字 + JIS/総務省コード)

search_by_address(query, limit?)

住所文字列 → 郵便番号候補(漢字/カナ/ローマ字横断、空白無視の部分一致)

list_cities_in_prefecture(prefecture)

都道府県名 → 市区町村一覧(総務省コード付き)

get_metadata()

データバージョン・件数・生成時刻

動作モデル

  • 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 tools
get_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

    A4.5/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: metadata retrieval, city listing, zip code lookup, and address search. No overlap or ambiguity.

    Naming Consistency5/5

    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.

    Tool Count5/5

    Four tools is appropriate for this domain, covering essential operations without being too sparse or excessive. Each tool earns its place.

    Completeness5/5

    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

    Related MCP Servers