PostalDataPI MCP Server

公式

70以上の国々に対応したグローバル郵便番号検索、バリデーション、都市検索。応答時間は10ミリ秒未満。

GitHub
1

PostalDataPI MCPで何ができますか？

  • 郵便番号を検索する — 指定された郵便番号に関連する市区町村、都道府県、地域を lookup_postal_code を使って問い合わせます。
  • 郵便番号を検証する — 特定の国に対して郵便番号が存在するかどうかを validate_postal_code で確認します。
  • 市区町村のすべてのコードを検索する — 特定の市区町村に該当するすべての郵便番号を search_by_city で取得します。
  • 完全な位置情報メタデータを取得する — 郵便番号の座標、タイムゾーン、標高、行政階層を get_postal_code_metadata でリクエストします。

ドキュメント

PostalDataPI MCP Server

License: MIT Python 3.10+ PyPI

PostalDataPI 用の MCP (Model Context Protocol) サーバーです。240以上の国と地域の郵便番号を AI エージェントが検索、検証、探索できるようにし、タイムゾーン、行政区画、標高、座標などの豊富なメタデータを提供します。

ツール

ツール説明
lookup_postal_code郵便番号（米国 ZIP、英国郵便番号、ドイツ PLZ など）から都市、州/地域、略称を取得します
validate_postal_codeある国に郵便番号が存在するかどうかを確認します
search_by_city特定の都市のすべての郵便番号を検索します
get_postal_code_metadata座標、行政階層、タイムゾーン、標高などの完全なメタデータを取得します

セットアップ

1. API キーを取得する

postaldatapi.com/register でサインアップしてください。1,000 回の無料クエリが利用可能で、クレジットカードは不要です。

2. インストール

pip install postaldatapi-mcp

3. Claude Code での設定

claude mcp add --transport stdio postaldatapi -- \
  env POSTALDATAPI_KEY=your_api_key_here postaldatapi-mcp

4. Claude Desktop での設定

Claude Desktop の設定ファイル (macOS では ~/Library/Application Support/Claude/claude_desktop_config.json) に以下を追加します。

{
  "mcpServers": {
    "postaldatapi": {
      "command": "postaldatapi-mcp",
      "env": {
        "POSTALDATAPI_KEY": "your_api_key_here"
      }
    }
  }
}

使用方法

設定が完了したら、Claude に自然に質問できます。

  • 「ZIP コード 90210 はどの都市ですか？」
  • 「英国の郵便番号 SW1A を調べて」
  • 「10115 は有効なドイツの郵便番号ですか？」
  • 「カリフォルニア州ビバリーヒルズの郵便番号は何ですか？」
  • 「日本の郵便番号 100-0001 の座標を取得して」

Claude は自動的に PostalDataPI ツールを使用して回答します。

サポート対象国

米国、英国、カナダ、ドイツ、フランス、日本、オーストラリア、ブラジル、インドなどを含む 240 以上の国と地域。完全なリストは postaldatapi.com/countries でご覧いただけます。

豊富なメタデータ

基本的な検索に加えて、get_postal_code_metadata ツールは郵便番号ごとに最大 18 のフィールドを返します。以下を含みます。

  • 座標 (緯度、経度)
  • タイムゾーン (例: America/Mexico_City, Europe/Berlin)
  • 行政階層 (州/県、郡、市区町村)
  • 標高 (海抜メートル)
  • 地名 および国情報

メキシコシティ 06000 の応答例:

{
  "postalCode": "06000",
  "country": "MX",
  "placeName": "Centro",
  "latitude": 19.4364,
  "longitude": -99.1553,
  "timezone": "America/Mexico_City",
  "adminLevel1": "Ciudad de México",
  "adminLevel2": "Cuauhtémoc",
  "elevation": 2239
}

リンク