Building Register

한국 건축물대장(국토교통부 건축HUB) 데이터를 조회하는 MCP 서버입니다.

특징

• 토큰 절약: 10개 엔드포인트를 도구 1개로 통합하여 컨텍스트 토큰 사용량 최소화
• 한글 필드명: API 응답을 한글 필드명으로 변환하여 AI가 바로 이해 가능
• JSON 응답: XML 대비 ~40% 토큰 절감, 공백 없는 압축 JSON 반환
• 필드 필터링: 엔드포인트별 필요한 필드만 반환하여 불필요한 토큰 소비 방지

조회 가능 데이터

endpoint	설명	주요 반환값
recap_title	총괄표제부	용적률, 건폐율, 세대수, 주차수, 사용승인일
title	표제부	동별 상세, 층수, 구조, 승강기, 내진설계
basis_ouln	기본개요	대장구분, 지역·지구·구역
flr_ouln	층별개요	층별 구조, 용도, 면적
expos_pubuse_area	전유공용면적	전유/공용 구분, 면적
expos	전유부	동·호별 층 정보
hsprc	주택가격	공시가격, 기준일자
wclf	오수정화시설	형식, 용량
atch_jibun	부속지번	부속 대지 정보
jijigu	지역지구구역	용도지역, 재건축 판단용

설치 및 실행

사전 준비

공공데이터포털에서 "건축물대장정보 서비스" API 키를 발급받으세요.

Claude Desktop

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "building-register": {
      "command": "npx",
      "args": ["building-register-mcp"],
      "env": {
        "DATA_GO_KR_API_KEY": "발급받은_API_키"
      }
    }
  }
}

Claude Code

claude mcp add building-register -- npx building-register-mcp

환경변수 설정:

DATA_GO_KR_API_KEY=발급받은_API_키 npx building-register-mcp

직접 실행

DATA_GO_KR_API_KEY=발급받은_API_키 npx building-register-mcp

파라미터

파라미터	필수	설명
endpoint	O	조회할 건축물대장 유형
sigungu_cd	O	시군구코드 (5자리)
bjdong_cd	O	법정동코드 (5자리)
plat_gb_cd		대지구분코드 (0:대지 1:산 2:블록, 기본 0)
bun		번
ji		지
start_date		검색시작일 (YYYYMMDD)
end_date		검색종료일 (YYYYMMDD)
num_of_rows		결과 수 (기본 10)
page_no		페이지 번호 (기본 1)

응답 예시

{"total_count":"32","items":[{"건물명":"개포자이","도로명주소":"서울특별시 강남구 개포로109길 69","용적률":250.64,"건폐율":18.91,"대지면적":15487.3,"건축면적":2927.93,"연면적":60400.03,"세대수":212,"주용도":"공동주택","총주차수":501,"사용승인일":"20040617"}]}

API 원본

• 국토교통부 건축HUB 건축물대장정보 서비스 (공공데이터포털)

라이선스

MIT