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：

• “邮政编码 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