PostalDataPI MCPサーバー

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

ツール

Related MCP server: Postio

セットアップ

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
}

リンク

• PostalDataPI

• APIリファレンス

• ドキュメント

• Python SDK

• Node.js SDK