PostalDataPI MCPサーバー

Name: PostalDataPI MCP Server
Author: PostalDataPI

License: MIT Python 3.10+ PyPI

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

ツール

ツール	説明
`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
}