building-register-mcp

한국 건축물대장(국토교통부 건축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