MCP 服务器

building-register-mcp

Queries South Korean building register data (e.g., floor area, parking, seismic design) via a single unified tool, converting API responses to Korean field names for easy AI understanding.

README

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