PostalDataPI MCP Server

chính thức

Tra cứu mã bưu chính toàn cầu, xác thực và tìm kiếm thành phố cho hơn 70 quốc gia. Phản hồi dưới 10ms.

GitHub

Tài liệu

PostalDataPI MCP Server

License: MIT Python 3.10+ PyPI

MCP (Model Context Protocol) server cho PostalDataPI — cho phép các tác nhân AI tra cứu, xác thực và tìm kiếm mã bưu chính trên hơn 240 quốc gia và vùng lãnh thổ với siêu dữ liệu phong phú: múi giờ, khu vực hành chính, độ cao và tọa độ.

Công cụ

Công cụMô tả
lookup_postal_codeLấy thành phố, bang/khu vực và tên viết tắt cho mã bưu chính (ZIP Mỹ, mã bưu chính Anh, PLZ Đức, v.v.)
validate_postal_codeKiểm tra xem mã bưu chính có tồn tại trong một quốc gia không
search_by_cityTìm tất cả mã bưu chính cho một thành phố
get_postal_code_metadataSiêu dữ liệu đầy đủ: tọa độ, phân cấp hành chính, múi giờ, độ cao và nhiều hơn nữa

Thiết lập

1. Lấy Khóa API

Đăng ký tại postaldatapi.com/register — 1.000 truy vấn miễn phí, không cần thẻ tín dụng.

2. Cài đặt

pip install postaldatapi-mcp

3. Cấu hình với Claude Code

claude mcp add --transport stdio postaldatapi -- \
  env POSTALDATAPI_KEY=your_api_key_here postaldatapi-mcp

4. Cấu hình với Claude Desktop

Thêm vào cấu hình Claude Desktop của bạn (~/Library/Application Support/Claude/claude_desktop_config.json trên macOS):

{
  "mcpServers": {
    "postaldatapi": {
      "command": "postaldatapi-mcp",
      "env": {
        "POSTALDATAPI_KEY": "your_api_key_here"
      }
    }
  }
}

Cách sử dụng

Sau khi cấu hình, hãy hỏi Claude một cách tự nhiên:

  • "Mã ZIP 90210 là thành phố nào?"
  • "Tra cứu mã bưu chính Anh SW1A"
  • "10115 có phải là mã bưu chính hợp lệ của Đức không?"
  • "Mã bưu chính cho Beverly Hills, CA là gì?"
  • "Lấy tọa độ cho mã bưu chính 100-0001 ở Nhật Bản"

Claude sẽ tự động sử dụng các công cụ PostalDataPI để trả lời.

Các quốc gia được hỗ trợ

Hơn 240 quốc gia và vùng lãnh thổ bao gồm Mỹ, Anh, Canada, Đức, Pháp, Nhật Bản, Úc, Brazil, Ấn Độ và nhiều quốc gia khác. Xem danh sách đầy đủ tại postaldatapi.com/countries.

Siêu dữ liệu phong phú

Ngoài các tra cứu cơ bản, công cụ get_postal_code_metadata trả về tối đa 18 trường cho mỗi mã bưu chính bao gồm:

  • Tọa độ (vĩ độ, kinh độ)
  • Múi giờ (ví dụ: America/Mexico_City, Europe/Berlin)
  • Phân cấp hành chính (bang/tỉnh, quận/hạt, đô thị)
  • Độ cao (mét trên mực nước biển)
  • Tên địa danh và thông tin quốc gia

Ví dụ phản hồi cho Thành phố Mexico 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
}

Liên kết