Skip to main content
Glama
Korea Building Register MCP

Korea Building Register MCP

🏢 Korea Building Register MCP

English | 한국어


English

Ask Claude about Korean building register data — powered by data.go.kr's Building Register API.

Provides 12 tools for querying building register (건축물대장) information including title sheets, floor details, exclusive-use areas, house prices, zoning, and more.

Supported Tools

Tool

Description

smart_building_lookup

🏢 Smart lookup — auto-detects general vs. collective buildings

search_bjdong_code

Search region codes (sigungu_cd, bjdong_cd) by name

get_building_title_info

Title sheet (표제부) — area, structure, usage, etc.

get_building_recap_title_info

Summary title sheet (총괄표제부)

get_building_basis_ouln_info

Basic outline (기본개요)

get_building_floor_ouln_info

Floor outline (층별개요)

get_building_expos_info

Exclusive-use units (전유부)

get_building_expos_pubuse_area_info

Exclusive/common area details (전유공용면적)

get_building_house_price_info

Official house prices (주택가격)

get_building_wclf_info

Sewage treatment facilities (오수정화시설)

get_building_atch_jibun_info

Attached land lots (부속지번)

get_building_jijigu_info

Zoning districts (지역지구구역)

Prerequisites

Quick Start: Claude Desktop (stdio)

  1. Clone this repository

git clone https://github.com/coding-realtor/building-register-mcp.git
cd building-register-mcp
  1. Open the Claude Desktop config file

# macOS
open "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Windows
notepad %APPDATA%\Claude\claude_desktop_config.json
  1. Add the entry below under mcpServers

{
  "mcpServers": {
    "building-register": {
      "command": "uv",
      "args": [
        "run",
        "--directory", "/path/to/building-register-mcp",
        "data-go-mcp-building-register"
      ],
      "env": {
        "BUILDING_REGISTER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Replace /path/to/building-register-mcp with the actual path where you cloned the repository.

  1. Restart Claude Desktop

Setup is complete when you can see the building-register server in the tool list.

Usage Example

Tell me about the building at 서울 종로구 청운동 89-3

Claude will automatically:

  1. Look up the region code via search_bjdong_code

  2. Call smart_building_lookup to fetch building details

  3. Present the results in a readable table


Related MCP server: ArchHub MCP

한국어

Claude에게 건축물대장 정보를 물어보세요 — 공공데이터포털 건축물대장정보 API 기반 MCP 서버입니다.

건축물대장 표제부, 층별개요, 전유부, 주택가격, 지역지구구역 등을 조회하는 12개 도구를 제공합니다.

제공 도구 (Tools)

Tool 명

설명

smart_building_lookup

🏢 스마트 조회 — 일반/집합건축물 자동 판별

search_bjdong_code

지역명으로 시군구코드·법정동코드 검색

get_building_title_info

건축물대장 표제부 (대지면적, 건축면적, 용적률 등)

get_building_recap_title_info

건축물대장 총괄표제부

get_building_basis_ouln_info

건축물대장 기본개요

get_building_floor_ouln_info

건축물대장 층별개요

get_building_expos_info

건축물대장 전유부 (동/호 정보)

get_building_expos_pubuse_area_info

건축물대장 전유공용면적

get_building_house_price_info

건축물대장 주택가격 (공시가격)

get_building_wclf_info

건축물대장 오수정화시설

get_building_atch_jibun_info

건축물대장 부속지번

get_building_jijigu_info

건축물대장 지역지구구역

사전 준비

빠른 시작: Claude Desktop (stdio)

  1. 레포지토리 클론

git clone https://github.com/coding-realtor/building-register-mcp.git
cd building-register-mcp
  1. Claude Desktop 설정 파일 열기

# macOS
open "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Windows
notepad %APPDATA%\Claude\claude_desktop_config.json
  1. mcpServers 항목에 아래 내용 추가

{
  "mcpServers": {
    "building-register": {
      "command": "uv",
      "args": [
        "run",
        "--directory", "C:\\path\\to\\building-register-mcp",
        "data-go-mcp-building-register"
      ],
      "env": {
        "BUILDING_REGISTER_API_KEY": "여기에_API_키_입력"
      }
    }
  }
}

C:\\path\\to\\building-register-mcp 부분을 실제 클론한 경로로 변경하세요.

  1. Claude Desktop 재시작

도구 목록에 building-register 서버가 표시되면 설정 완료입니다.

사용 예시 (Claude에서)

서울 종로구 청운동 89-3 건물의 건축물대장 조회해줘
강남구 역삼동 736번지 건물의 주택 공시가격을 알려줘
송파구 잠실동 40번지 아파트의 동/호 목록을 보여줘

Claude가 자동으로:

  1. search_bjdong_code로 시군구/법정동 코드를 검색

  2. smart_building_lookup으로 건축물 정보를 조회

  3. 결과를 보기 좋은 표로 정리하여 보여줍니다

Gemini CLI / 기타 MCP 클라이언트

Gemini CLI 등 다른 MCP 클라이언트에서도 동일하게 사용할 수 있습니다. 설정 파일의 MCP 서버 항목에 위와 같은 형식으로 추가하세요.

로컬 테스트

# 서버 직접 실행
uv run data-go-mcp-building-register

라이센스

Apache-2.0 — 자세한 내용은 LICENSE 파일을 참고하세요.

Available Tools

12 tools
get_building_atch_jibun_infoA
건축물대장 부속지번을 조회합니다.

건축물과 관련된 부속지번의 지번주소 및 새주소, 부속대장구분 등의 정보를 제공합니다.

Args:
    sigungu_cd: 시군구코드 (5자리, 예: 11110 = 서울 종로구)
    bjdong_cd: 법정동코드 (5자리, 예: 10100)
    plat_gb_cd: 대지구분코드 (0: 대지, 1: 산, 2: 블록)
    bun: 번 (4자리, 예: 0001)
    ji: 지 (4자리, 예: 0000)
    mgm_bldrgst_pk: 관리건축물대장PK
    page_no: 페이지 번호 (기본값: 1)
    num_of_rows: 한 페이지 결과 수 (기본값: 100)

Returns:
    Dictionary containing:
    - items: 부속지번 정보 목록 (지번주소, 부속대장구분, 법정동명 등)
    - page_no: 현재 페이지 번호
    - num_of_rows: 페이지당 결과 수
    - total_count: 전체 결과 수

Inputs: sigungu_cd, bjdong_cd, plat_gb_cd, bun, +4 more. Returns: result

get_building_basis_ouln_infoA
건축물대장 기본개요를 조회합니다.

대장종류, 대장구분, 지번주소 및 새주소, 지역/지구/구역 등의 기본정보를 제공합니다.

Args:
    sigungu_cd: 시군구코드 (5자리, 예: 11110 = 서울 종로구)
    bjdong_cd: 법정동코드 (5자리, 예: 10100)
    plat_gb_cd: 대지구분코드 (0: 대지, 1: 산, 2: 블록)
    bun: 번 (4자리, 예: 0001)
    ji: 지 (4자리, 예: 0000)
    mgm_bldrgst_pk: 관리건축물대장PK
    page_no: 페이지 번호 (기본값: 1)
    num_of_rows: 한 페이지 결과 수 (기본값: 100)

Returns:
    Dictionary containing:
    - items: 기본개요 정보 목록 (대장종류, 대장구분, 지번주소, 지역/지구/구역 등)
    - page_no: 현재 페이지 번호
    - num_of_rows: 페이지당 결과 수
    - total_count: 전체 결과 수

Inputs: sigungu_cd, bjdong_cd, plat_gb_cd, bun, +4 more. Returns: result

get_building_expos_infoA
건축물대장 전유부를 조회합니다.

건축물대장 전유부의 지번주소 및 새주소, 동/호명칭 등의 정보를 제공합니다.
dong_nm과 ho_nm으로 특정 동/호를 직접 필터링할 수 있습니다.

Args:
    sigungu_cd: 시군구코드 (5자리, 예: 11110 = 서울 종로구)
    bjdong_cd: 법정동코드 (5자리, 예: 10100)
    plat_gb_cd: 대지구분코드 (0: 대지, 1: 산, 2: 블록)
    bun: 번 (4자리, 예: 0001)
    ji: 지 (4자리, 예: 0000)
    mgm_bldrgst_pk: 관리건축물대장PK
    dong_nm: 동명칭 (예: "126동") - 특정 동으로 필터링
    ho_nm: 호명칭 (예: "1704호") - 특정 호로 필터링
    page_no: 페이지 번호 (기본값: 1)
    num_of_rows: 한 페이지 결과 수 (기본값: 100)

Returns:
    Dictionary containing:
    - items: 전유부 정보 목록 (건물명, 동명칭, 호명칭, 주부속구분 등)
    - page_no: 현재 페이지 번호
    - num_of_rows: 페이지당 결과 수
    - total_count: 전체 결과 수

Inputs: sigungu_cd, bjdong_cd, plat_gb_cd, bun, +6 more. Returns: result

get_building_expos_pubuse_area_infoA
건축물대장 전유공용면적을 조회합니다.

🚨 [중요/MCP 지침] 🚨
1. 이 API는 mgmBldrgstPk를 공식 파라미터로 지원하지 않습니다.
   반드시 주소(sigungu_cd + bjdong_cd + bun + ji) + dongNm + hoNm 으로 조회하세요.
2. hoNm은 "401호" 또는 "401" 모두 가능합니다 (내부에서 자동 정규화).
3. dongNm은 "118동" 형식 그대로 입력하세요.

전유/공용면적의 층구분, 층번호, 전유/공용구분, 구조, 용도 등의 정보를 제공합니다.

Args:
    sigungu_cd: 시군구코드 (5자리, 예: 11110 = 서울 종로구)
    bjdong_cd: 법정동코드 (5자리, 예: 10100)
    plat_gb_cd: 대지구분코드 (0: 대지, 1: 산, 2: 블록)
    bun: 번 (4자리, 예: 0001)
    ji: 지 (4자리, 예: 0000)
    dong_nm: 동명칭 (예: "118동")
    ho_nm: 호명칭 (예: "401" 또는 "401호")
    page_no: 페이지 번호 (기본값: 1)
    num_of_rows: 한 페이지 결과 수 (기본값: 100)

Returns:
    Dictionary containing:
    - items: 전유공용면적 정보 목록 (층구분, 층번호, 전유/공용구분, 구조, 용도, 면적 등)
    - page_no: 현재 페이지 번호
    - num_of_rows: 페이지당 결과 수
    - total_count: 전체 결과 수

Inputs: sigungu_cd, bjdong_cd, plat_gb_cd, bun, +5 more. Returns: result

get_building_floor_ouln_infoA
건축물대장 층별개요를 조회합니다.

🚨 [중요/MCP 지침] 🚨
1. 집합건축물(아파트, 오피스텔, 상가 등 여러 동이 있는 건물)의 경우,
   주소(sigungu_cd+bjdong_cd+bun+ji)로만 조회하면 해당 대지 위 모든 동의
   층별 정보가 혼재되어 반환됩니다.
   반드시 mgm_bldrgst_pk를 지정하여 특정 동의 층별 정보만 조회하세요.
2. mgm_bldrgst_pk는 smart_building_lookup 또는 get_building_title_info의
   응답에서 "관리PK" 필드로 확인할 수 있습니다.
3. 값을 잊었거나 빈 결과가 나오면, 터미널(grep 등)로 과거 대화 로그를 무단 검색하지 말고
   정상적으로 표제부 API를 올바른 코드로 다시 호출하여 찾으세요.

건축물의 층구분, 층번호, 층의 구조, 용도, 면적 등의 층별 정보를 제공합니다.

Args:
    sigungu_cd: 시군구코드 (5자리, 예: 11110 = 서울 종로구)
    bjdong_cd: 법정동코드 (5자리, 예: 10100)
    plat_gb_cd: 대지구분코드 (0: 대지, 1: 산, 2: 블록)
    bun: 번 (4자리, 예: 0001)
    ji: 지 (4자리, 예: 0000)
    mgm_bldrgst_pk: 관리건축물대장PK (집합건축물은 필수 — 없으면 다른 동 데이터 혼재)
    page_no: 페이지 번호 (기본값: 1)
    num_of_rows: 한 페이지 결과 수 (기본값: 100)

Returns:
    Dictionary containing:
    - items: 층별개요 정보 목록 (층구분, 층번호, 구조, 용도, 면적 등)
    - page_no: 현재 페이지 번호
    - num_of_rows: 페이지당 결과 수
    - total_count: 전체 결과 수

Inputs: sigungu_cd, bjdong_cd, plat_gb_cd, bun, +4 more. Returns: result

get_building_house_price_infoA
건축물대장 주택가격을 조회합니다.

건축물대장 대상 주택의 공시가격 정보를 제공합니다.

Args:
    sigungu_cd: 시군구코드 (5자리, 예: 11110 = 서울 종로구)
    bjdong_cd: 법정동코드 (5자리, 예: 10100)
    plat_gb_cd: 대지구분코드 (0: 대지, 1: 산, 2: 블록)
    bun: 번 (4자리, 예: 0001)
    ji: 지 (4자리, 예: 0000)
    mgm_bldrgst_pk: 관리건축물대장PK
    page_no: 페이지 번호 (기본값: 1)
    num_of_rows: 한 페이지 결과 수 (기본값: 100)

Returns:
    Dictionary containing:
    - items: 주택가격 정보 목록 (건물명, 호명칭, 공시가격, 기준년도 등)
    - page_no: 현재 페이지 번호
    - num_of_rows: 페이지당 결과 수
    - total_count: 전체 결과 수

Inputs: sigungu_cd, bjdong_cd, plat_gb_cd, bun, +4 more. Returns: result

get_building_jijigu_infoA
건축물대장 지역지구구역을 조회합니다.

건축물과 관련된 지역/지구/구역의 구분 및 명칭, 대표여부 등의 정보를 제공합니다.

Args:
    sigungu_cd: 시군구코드 (5자리, 예: 11110 = 서울 종로구)
    bjdong_cd: 법정동코드 (5자리, 예: 10100)
    plat_gb_cd: 대지구분코드 (0: 대지, 1: 산, 2: 블록)
    bun: 번 (4자리, 예: 0001)
    ji: 지 (4자리, 예: 0000)
    mgm_bldrgst_pk: 관리건축물대장PK
    page_no: 페이지 번호 (기본값: 1)
    num_of_rows: 한 페이지 결과 수 (기본값: 100)

Returns:
    Dictionary containing:
    - items: 지역지구구역 정보 목록 (지역지구구역구분, 지역지구구역명, 대표여부 등)
    - page_no: 현재 페이지 번호
    - num_of_rows: 페이지당 결과 수
    - total_count: 전체 결과 수

Inputs: sigungu_cd, bjdong_cd, plat_gb_cd, bun, +4 more. Returns: result

get_building_recap_title_infoA
건축물대장 총괄표제부를 조회합니다.

총괄표제부의 지번주소 및 새주소, 대지면적, 건축면적, 연면적, 건폐율, 용적율,
용도, 주차방식 및 주차대수, 부속건축물의 면적, 허가관리기관, 에너지관련 등급 등의 정보를 제공합니다.

Args:
    sigungu_cd: 시군구코드 (5자리, 예: 11110 = 서울 종로구)
    bjdong_cd: 법정동코드 (5자리, 예: 10100)
    plat_gb_cd: 대지구분코드 (0: 대지, 1: 산, 2: 블록)
    bun: 번 (4자리, 예: 0001)
    ji: 지 (4자리, 예: 0000)
    mgm_bldrgst_pk: 관리건축물대장PK
    page_no: 페이지 번호 (기본값: 1)
    num_of_rows: 한 페이지 결과 수 (기본값: 100)

Returns:
    Dictionary containing:
    - items: 총괄표제부 정보 목록 (대지면적, 건축면적, 연면적, 건폐율, 용적률, 주차대수, 에너지효율등급 등)
    - page_no: 현재 페이지 번호
    - num_of_rows: 페이지당 결과 수
    - total_count: 전체 결과 수

Inputs: sigungu_cd, bjdong_cd, plat_gb_cd, bun, +4 more. Returns: result

get_building_title_infoA
건축물대장 표제부를 조회합니다.

🚨 [중요/MCP 지침] 🚨
이 툴을 포함한 모든 건축물대장 API 호출 시에는 search_bjdong_code 에서 검색한 
올바른 시군구코드(sigungu_cd)와 법정동코드(bjdong_cd)를 절대 틀리지 않게 기입해야 합니다.
만약 조회 결과가 없다고 해서 터미널로 대화 로그(transcript)를 뒤지는 행동은 금지되어 있습니다.

건축물의 지번주소 및 새주소, 주/부속구분, 대지면적, 건축면적, 건폐율, 용적율,
구조, 용도, 지붕구조, 주차대수 등의 표제부 정보를 제공합니다.

Args:
    sigungu_cd: 시군구코드 (5자리, 예: 11110 = 서울 종로구)
    bjdong_cd: 법정동코드 (5자리, 예: 10100)
    plat_gb_cd: 대지구분코드 (0: 대지, 1: 산, 2: 블록)
    bun: 번 (4자리, 예: 0001)
    ji: 지 (4자리, 예: 0000)
    mgm_bldrgst_pk: 관리건축물대장PK
    page_no: 페이지 번호 (기본값: 1)
    num_of_rows: 한 페이지 결과 수 (기본값: 100)

Returns:
    Dictionary containing:
    - items: 표제부 정보 목록 (건물명, 대지면적, 건축면적, 연면적, 건폐율, 용적률, 구조, 용도, 사용승인일 등)
    - page_no: 현재 페이지 번호
    - num_of_rows: 페이지당 결과 수
    - total_count: 전체 결과 수

Inputs: sigungu_cd, bjdong_cd, plat_gb_cd, bun, +4 more. Returns: result

get_building_wclf_infoA
건축물대장 오수정화시설을 조회합니다.

건축물과 관련된 오수정화시설의 오수정화형식, 용량, 용량단위 등의 정보를 제공합니다.

Args:
    sigungu_cd: 시군구코드 (5자리, 예: 11110 = 서울 종로구)
    bjdong_cd: 법정동코드 (5자리, 예: 10100)
    plat_gb_cd: 대지구분코드 (0: 대지, 1: 산, 2: 블록)
    bun: 번 (4자리, 예: 0001)
    ji: 지 (4자리, 예: 0000)
    mgm_bldrgst_pk: 관리건축물대장PK
    page_no: 페이지 번호 (기본값: 1)
    num_of_rows: 한 페이지 결과 수 (기본값: 100)

Returns:
    Dictionary containing:
    - items: 오수정화시설 정보 목록 (오수정화형식, 용량, 용량단위 등)
    - page_no: 현재 페이지 번호
    - num_of_rows: 페이지당 결과 수
    - total_count: 전체 결과 수

Inputs: sigungu_cd, bjdong_cd, plat_gb_cd, bun, +4 more. Returns: result

search_bjdong_codeA
건축물대장 API 조회용 시군구코드(sigungu_cd) 및 법정동코드(bjdong_cd)를 지역명(예: 강동구 고덕동)으로 검색하여 빠르게 찾습니다.
사용자의 주소 관련 질의에 대해 본 API를 호출하기 전에 코드를 획득하기 위해 반드시 이 툴을 먼저 사용하세요.

Inputs: query (required). Returns: result

smart_building_lookupA
🏢 건축물대장 스마트 조회 — 주소 하나로 건축물 전체 개요를 자동으로 파악합니다.

이 도구는 사용자가 건축물대장을 조회할 때 가장 먼저 호출해야 하는 핵심 도구입니다.
search_bjdong_code로 코드를 얻은 뒤 이 도구를 호출하세요.

[자동 처리 흐름]
1. 기본개요를 조회하여 일반건축물 vs 집합건축물 자동 판별
2. 일반건축물: 표제부 + 층별 정보를 한번에 조회하여 반환 (데이터 적음)
3. 집합건축물: 총괄표제부 요약 + 표제부(동 목록)를 조회하되,
   전유부(5,000건 이상 가능)는 조회하지 않고 "동/호 선택 안내"를 반환

[반환 후 AI 행동 지침]
- 일반건축물: 바로 결과를 사용자에게 표로 보여주세요.
- 집합건축물: 총괄표제부 요약과 동 목록을 보여준 뒤,
  "어느 동/호의 상세정보를 조회할까요?" 라고 사용자에게 물어보세요.
  사용자가 동/호를 지정하면 get_building_expos_info (전유부) 또는
  get_building_expos_pubuse_area_info (전유공용면적) 를 해당 동/호로 호출하세요.
  ⚠️ 전유공용면적은 mgm_bldrgst_pk를 지원하지 않으므로 반드시 주소+동+호로 조회하세요.

Args:
    sigungu_cd: 시군구코드 (5자리, search_bjdong_code로 조회)
    bjdong_cd: 법정동코드 (5자리, search_bjdong_code로 조회)
    bun: 번 (4자리, 예: 0843)
    ji: 지 (4자리, 기본값: 0000)
    plat_gb_cd: 대지구분코드 (0: 대지, 1: 산, 기본값: 0)

Inputs: sigungu_cd (required), bjdong_cd (required), bun (required), ji, +1 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 12 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting specific aspects of building registry data (e.g., basic overview, floor details, ownership information, sewage facilities). The descriptions clearly differentiate what each tool retrieves, with no apparent overlap in functionality. An agent can easily distinguish between tools like get_building_floor_ouln_info for floor-level data and get_building_expos_info for ownership unit details.

    Naming Consistency5/5

    All tools follow a consistent snake_case naming pattern with a clear 'get_' or 'search_' prefix followed by a descriptive noun phrase. The naming convention is uniform across all 12 tools, making them predictable and easy to parse. Even the two non-get tools (search_bjdong_code and smart_building_lookup) maintain the same structural consistency.

    Tool Count5/5

    With 12 tools, the server is well-scoped for its domain of building registry data in Korea. Each tool serves a specific, necessary function (e.g., retrieving different sections of the building registry, searching for codes, smart lookups). The count is neither too sparse nor excessive, covering various data aspects without redundancy.

    Completeness5/5

    The toolset provides comprehensive coverage for building registry queries, including code search (search_bjdong_code), smart overview (smart_building_lookup), and detailed retrievals for all major registry sections (title, floor, ownership, area, price, etc.). There are no obvious gaps; agents can navigate from address lookup to detailed data retrieval seamlessly, with tools like smart_building_lookup guiding workflows effectively.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides AI access to Korea's land use planning, urban regulations, and permit information through natural language queries. It integrates tools for land analysis, regulation verification, and public notice scraping to prevent hallucinations in property-related AI applications.
      8
      19
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables natural language access to 11 Korean building data tools including building registers, permits, comprehensive profiles with zoning, floor composition, district statistics, old building analysis, price history, demolitions, and permit pipeline.
      76
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      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.
      19 npm
      2
      MIT