MCP Server

MCP Serverとは

Model Context Protocol (MCP) は、AIアシスタントが外部ツールやデータソースに安全にアクセスするためのオープンプロトコルです。

mcp-server-postcode をインストールすると、Claude Desktop や Claude Code などのAIアシスタントから自然言語で郵便番号の検索、住所の取得、都道府県一覧の確認などができるようになります。

10種類のツール 郵便番号・住所・建物・事業所

認証不要 APIキーなしで即利用可能

npxで即実行 インストール不要で起動

セットアップ

1

Claude Desktop

Claude Desktop アプリケーションで利用する場合

Step 1 設定ファイルを開く

Claude Desktop の設定画面から「Developer」→「Edit Config」を開き、claude_desktop_config.json を編集します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Step 2 MCP サーバーを追加

以下の設定を mcpServers セクションに追加します。

json

{
  "mcpServers": {
    "postcode": {
      "command": "npx",
      "args": ["-y", "mcp-server-postcode"]
    }
  }
}

Step 3 Claude Desktop を再起動

設定を保存したら Claude Desktop を再起動します。チャット入力欄にツールアイコンが表示されれば設定完了です。

2

Claude Code (CLI)

ターミナルの Claude Code で利用する場合

Step 1 コマンド一行で追加

以下のコマンドを実行するだけでセットアップ完了です。

bash

claude mcp add postcode -- npx -y mcp-server-postcode

Step 2 動作確認

Claude Code を起動して、郵便番号に関する質問をしてみましょう。

bash

claude

> 東京タワーの郵便番号を教えて

3

手動実行 / その他のクライアント

npx で直接起動する場合や、他の MCP クライアントで利用する場合

Step 1 npx で実行

標準入出力 (stdio) を介して MCP プロトコルで通信します。

bash

npx -y mcp-server-postcode

環境変数 POSTCODE_API_URL で API のベース URL を変更できます。

利用可能なツール

郵便番号

search_postcodes

住所キーワードで郵便番号を検索

query 検索キーワード page ページ番号 per 件数/ページ

get_postcode

7桁の郵便番号から住所詳細を取得

code 7桁郵便番号

get_postcode_text

郵便番号からプレーンテキストで住所を取得

code 7桁郵便番号 part 1=県 2=市 3=町 4=番地 5=建物

都道府県・市区町村

list_prefectures

全47都道府県の一覧を取得

get_prefecture_cities

都道府県コードから市区町村一覧を取得

code 都道府県コード (1-47)

get_city_postcodes

市区町村の全郵便番号を取得

code 都道府県コード city 市区町村名

建物

search_buildings

階層別郵便番号を持つ建物を検索

query 建物名キーワード

get_building

建物の階層別郵便番号一覧を取得

name 建物名

事業所

search_offices

事業所個別郵便番号を検索

query 事業所名キーワード

get_office

事業所郵便番号の詳細を取得

code 7桁郵便番号

活用例

CASE 1 住所から郵便番号を調べる

引っ越し先の住所から郵便番号を検索する場面で、AIに自然言語で尋ねるだけで即座に結果を取得できます。

You

引っ越し先が「東京都港区六本木」なんだけど、郵便番号を教えて

Tool: search_postcodes

{ "query": "港区六本木" }

Claude

東京都港区六本木の郵便番号は 〒106-0032 です。
転居届の郵便番号欄にはハイフンなしで「1060032」と記入してください。

CASE 2 郵便番号から住所を自動入力

Eコマースサイト開発中に、郵便番号から住所を取得するロジックのテストデータを生成する例です。

You

1600023 の住所をJSON形式で教えて。フロントの住所自動入力のテストに使いたい。

Tool: get_postcode

{ "code": "1600023" }

Claude

json

{
  "postcode": "1600023",
  "prefecture": "東京都",
  "city": "新宿区",
  "suburb": "西新宿",
  "prefecture_kana": "トウキョウト",
  "city_kana": "シンジュクク",
  "suburb_kana": "ニシシンジュク"
}

CASE 3 複数拠点の郵便番号を一括調査

企業の支社一覧を作成する際に、各オフィスの郵便番号を効率的に調査できます。

You

東京都内の「新宿」がつく地域の郵便番号をリストアップして、CSVフォーマットで出力して。

Tool: search_postcodes

{ "query": "東京都新宿", "per": 50 }

Claude

csv

郵便番号,都道府県,市区町村,町域
1600000,東京都,新宿区,(以下に掲載がない場合)
1600001,東京都,新宿区,片町
1600003,東京都,新宿区,四谷本塩町
1600004,東京都,新宿区,四谷
1600005,東京都,新宿区,愛住町
...

CASE 4 高層ビルの階層別郵便番号を確認

大規模オフィスビルでは階層ごとに郵便番号が異なる場合があります。建物検索ツールで簡単に確認できます。

You

六本木ヒルズの郵便番号って階ごとに違うの？

Tool: search_buildings

{ "query": "六本木ヒルズ" }

Claude

はい、六本木ヒルズ森タワーは階層ごとに異なる郵便番号が割り当てられています。例えば：

〒106-6101 — 1階
〒106-6102 — 2階
〒106-6190 — 地階・階層不明

郵便物を送る際は、宛先の階数に対応した郵便番号を使いましょう。

MCP Serverとは

セットアップ

Claude Desktop

Claude Code (CLI)

手動実行 / その他のクライアント

利用可能なツール

郵便番号

都道府県・市区町村

建物

事業所

活用例

関連リンク