건축물대장 코드를 외우고, 법정동코드를 조립하고, 표제부 PDF를 스크롤하던 일을 주소 한 줄로. 표제부·층별 구성·노후건물·철거(석면)·공시지가까지 — 전부 data.go.kr 공식 API 실측값이라 그대로 인용 가능. 데이터가 없으면 추측하지 않고 [NOT_FOUND]로 답한다.
일반 AI에게 "이 건물 건폐율"을 물으면 그럴듯한 숫자를 자신 있게 지어낸다. 그 수치가 안전점검 보고서·재건축 검토·감정평가에 들어가면 사고다. 이 커넥터는 매번 건축HUB 공식 API를 실시간 조회하고, 데이터가 없으면 [NOT_FOUND], API 오류면 [EXTERNAL_API_ERROR]를 앞에 붙인다. 추측이 아니라 대장이다.
건폐율·용적률·구조·용도·사용승인일 전부 data.go.kr 건축HUB 원본. 안전점검·재건축 검토·감정평가 자료에 그대로 인용. 출처(서비스명)가 따라붙는다.
대장에 없는 건물·항목은 광역 평균이나 일반론으로 메우지 않고 "데이터 없음"을 명시. LLM이 빈칸을 상상으로 채우는 사고를 원천 차단.
건축HUB 응답 실패는 [EXTERNAL_API_ERROR]로 표면화. 빈 응답을 "0건"으로 둔갑시키지 않아, 조회 실패와 진짜 없음을 구분.
공용 인증키를 원격 서버에 탑재. 사용자는 키 발급·환경변수 없이 커넥터 URL 한 줄만 등록하면 끝. 발급·세팅 장벽 제로.
building_profile은 흩어진 표제부 항목 — 용도지역·주용도·구조·규모·건폐율/용적률을 한 장으로 묶는다. building_floors는 지하부터 옥상까지 층별 용도·면적을 스택으로. 주소는 먼저 find_region이 시군구·법정동 코드로 변환한 뒤 넘어간다.
예시 수치는 표제부 레이아웃을 설명하기 위한 것 — 실제 호출은 입력 주소의 건축HUB 실측값으로 채워진다. 층별 용도·면적이 다르면 building_floors가 층마다 분리해 보여준다.
개별 조회를 넘어 자치구 단위 집계까지. 노후건물 선별·철거 이력·정비 대상 검토 — 관공서 건축·안전 부서가 매일 만나는 동선을 도구 3종으로 묶었다.
district_statsold_buildingsdemolitions준공연도 기준 연식 필터. "○○동 30년/40년 이상" 한 줄이면 안전점검·재건축 대상 후보가 리스트로. 광역 평균이 아닌 동 단위 실측.
demolitions가 철거 건물의 석면 함유 부위를 표기. 철거 전 석면 조사·안전관리 대상을 사전에 식별.
자치구 건축물의 주용도 분포, 준공연도 코호트, 규모 벤치마크를 한 번에. 정비계획·도시계획 기초통계로 바로.
"광진구 자양동"을 시군구코드/법정동코드로 변환해 다른 도구에 넘긴다. 같은 이름 동(○○동)도 상위 시군구를 같이 말하면 정확히 구분.
permits_pipeline은 사용승인 전(진행 중) 인허가를 공정 단계별로 추적한다. price_history는 공시지가를 시계열로 묶고 CAGR(연평균 변화율)까지 계산 — 감정평가·개발 검토의 시간축 근거.
사용승인 전 인허가를 공정 단계별로. "이 동네 지금 짓는 중인 건물"을 한 줄로 — 주변 개발 동향·민원 대응·교통영향 검토에.
필지별 공시지가 시계열 + 연평균 변화율. 단순 현재값이 아니라 궤적으로 본다. 감정평가·개발 타당성 검토의 정량 근거.
v0.4.0에서 raw 3종을 building_data 하나로 통합. kind=ledger(대장 10종) · permit(인허가 17종) · housing(주택 16종) — 총 43개 문서 서식에 직접 접근. 도구 수를 줄여 LLM 도구 선택 혼란과 스키마 토큰을 함께 절감.
건축물대장 BldRgstHubService · 건축인허가 ArchPmsHubService · 주택인허가 HsPmsHubService를 하나의 MCP로 통합. 호출은 직접 REST로 timeout·행수 제어.
find_region · building_profile · district_stats가 일상 질의의 대부분. 나머지는 정밀 조회·원문 서식용.
Claude.ai 웹 커넥터(설치·키 없음) · Claude Code 한 줄 · 데스크톱 앱(mcp-remote) · 로컬 실행(오프라인). 원격은 공용키 탑재라 API 키 발급조차 필요 없다.
Claude Pro/Max/Team — 설정 → 커넥터 → 커스텀 커넥터 추가. URL 한 줄, 키 없음.
https://mcp.gomdori.app/archhub
터미널에서 streamable-http 트랜스포트로 바로 추가.
claude mcp add --transport http \ archhub https://mcp.gomdori.app/archhub
mcp-remote 어댑터로 원격 서버 연결. 다른 MCP 서버는 그대로.
{
"mcpServers": {
"archhub": {
"command": "npx",
"args": ["-y", "mcp-remote",
"https://mcp.gomdori.app/archhub"]
}
}
}
data.go.kr 인증키(무료)와 Python 3.10+. 키는 환경변수로.
git clone https://github.com/chrisryugj/archhub-mcp export ARCHHUB_SERVICE_KEY="<decoded-key>" archhub-mcp --transport http --port 8000