mcp-server-jpzip

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

• 配信元: https://jpzip.nadai.dev

• データ仕様: jpzip/spec

• 元データ: 日本郵便 KEN_ALL / KEN_ALL_ROME(月次更新追従)

インストール (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"]
    }
  }
}

提供 Tool

動作モデル

• 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 相当(日本郵便)。