PostalDataPI MCP Server

공식

전 세계 70개 이상 국가의 우편번호 조회, 유효성 검사 및 도시 검색. 10ms 미만의 응답 속도.

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에서 가입하세요 — 신용카드 없이 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
}

링크