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 설정(~/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
}

링크

• PostalDataPI

• API 참조

• 문서

• Python SDK

• Node.js SDK