PostalDataPI MCP Server

官方

全球郵遞區號查詢、驗證及城市搜尋，支援70多個國家，回應時間低於10毫秒。

GitHub

文件

PostalDataPI MCP Server

License: MIT Python 3.10+ PyPI

MCP (Model Context Protocol) 伺服器，用於 PostalDataPI — 讓 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：

  • 「郵遞區號 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
}

連結