PostalDataPI MCP 서버

Name: PostalDataPI MCP Server
Author: PostalDataPI

License: MIT Python 3.10+ PyPI

PostalDataPI용 MCP(Model Context Protocol) 서버입니다. 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 설정(~/Library/Application Support/Claude/claude_desktop_config.json, macOS 기준)에 추가하세요:

{
  "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
}