PostalDataPI MCP Server

官方

全球邮政编码查询、验证及城市搜索，覆盖70多个国家，响应时间低于10毫秒。

GitHub

文档

PostalDataPI MCP 服务器

License: MIT Python 3.10+ PyPI

用于 PostalDataPI 的 MCP（模型上下文协议）服务器——让 AI 代理能够查询、验证和搜索 240 多个国家和地区 的邮政编码，并获取丰富的元数据：时区、行政区划、海拔和坐标。

工具

工具描述
lookup_postal_code获取邮政编码（美国 ZIP、英国邮编、德国 PLZ 等）对应的城市、州/地区和缩写
validate_postal_code检查某个邮政编码在某个国家是否存在
search_by_city查找某个城市的所有邮政编码
get_postal_code_metadata完整元数据：坐标、行政层级、时区、海拔等

设置

1. 获取 API 密钥

在 postaldatapi.com/register 注册——1000 次免费查询，无需信用卡。

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
}

链接