"자양동 2-2번지 건물 정보 한눈에 보여줘"
→ building_profile(11215, 10500, bun=2, ji=2)

건축물 1개 동
용도지역·지구: 지구단위계획구역 · 일반상업지역

■ 건대입구역자이엘라
  위치: 서울특별시 광진구 능동로 87 (자양동)
  용도: 업무시설 (기타: 업무시설(오피스텔),근린생활시설,문화및집회시설,공공업무시설)  ·  구조: 철골철근콘크리트합성구조
  규모: 지상20/지하6층 · 높이 99.6m · 연면적 28,515.35㎡ · 대지 2,288.50㎡
  건폐율 59.9781% · 용적률 787.882%
  세대: 0세대 0가구 366호
  주차: 자주식 115대 · 기계식 120대
  사용승인 2022-10-07 · 허가 2018-04-18 · 착공 2019-09-26
  내진 1(Ⅶ-0.176g)

출처: 국토교통부 건축HUB (공공데이터포털 data.go.kr)

"자양동 2-2번지 층별로 뭐가 있는지 보여줘"
→ building_floors(11215, 10500, bun=2, ji=2)

■ 층별 구성 — 건대입구역자이엘라
  총 27개 층 (행 31건)

     옥탑         73㎡  오피스텔 73㎡
    20층        732㎡  오피스텔 732㎡
     ...
     6층      1,242㎡  예식장 1,242㎡
     5층      1,242㎡  일반음식점 1,242㎡
     3층      1,890㎡  기타공공업무시설 1,799㎡ · 놀이형시설 91㎡
     1층      1,229㎡  일반음식점 1,060㎡ · 오피스텔 169㎡
   지하1층      1,481㎡  일반음식점 1,481㎡
   지하6층      1,812㎡  오피스텔 1,812㎡

출처: 국토교통부 건축HUB (공공데이터포털 data.go.kr)

"자양동 건축물 통계 내줘"
→ district_stats(11215, 10500)

[법정동 건축물 통계] 표제부 6057건 기준

■ 총괄
  총 6,057동 · 총 연면적 5,283,211㎡ · 평균 3.5층 · 평균 경과 32년

■ 주용도별 (상위 10)
  단독주택          3,543동 (58.5%) · 연면적 841,139㎡
  공동주택          1,346동 (22.2%) · 연면적 2,726,331㎡
  제1종근린생활시설       532동 ( 8.8%) · 연면적 280,975㎡
  ...

■ 사용승인 연대별
  1970s      814동 (13.4%)
  1980s    1,376동 (22.7%)
  1990s    2,094동 (34.6%)
  ...

■ 노후도 분포 (사용승인 경과연수)
  30~40년    2,563동 (42.3%)  ⚠
  40년 이상    1,551동 (25.6%)  ⚠
  → 경과 30년↑ 합계 4,114동 (67.9%)

출처: 국토교통부 건축HUB (공공데이터포털 data.go.kr)

"자양동에서 40년 넘은 노후 건물 뽑아줘"
→ old_buildings(11215, 10500, min_age_years=40)

총 1551건 중 상위 30건 표시
표제부 6057건 중 경과 40년↑ 1551건 (경과연수 내림차순)

건물명  도로명대지위치   대지위치               주용도코드명  사용승인일   경과연수  연면적  지상층수  세대수
            서울특별시 광진구 자양동 268번지   단독주택  1924-07-20    102  16.53     1    0
            서울특별시 광진구 자양동 203번지   단독주택  1926-08-20    100  59.50     1    0
            ...

"자양동 24-28번지 공시가격 추이 보여줘"
→ price_history(11215, 10500, bun=24, ji=28)

[공시가격 시계열] 24-28 · 주택가격 238건 · 14호
최신 공시가 상위 10호 표시 (top_units로 조정)

■ 호 PK…0216 · 새주소 22
  최신 4.65억 (2025) · 최초 2.45억 (2009) · 16년간 +89.8% · 연평균 +4.1%
  추이: '09 2.45억 → '12 2.64억 → '15 2.64억 → '19 3.44억 → '22 4.54억 → '25 4.65억

※ 공시가격은 시세가 아닙니다(통상 시세의 60~70% 수준, 연도별 현실화율 정책 변동 포함). 증감률·CAGR을 시세·실거래가 상승률로 해석하지 마세요.
출처: 국토교통부 건축HUB (공공데이터포털 data.go.kr)

"자양동 2018년 이후 철거된 건물 보여줘"
→ demolitions(11215, 10500, since_year=2018)

[철거멸실 현황] 철거멸실 1771건 중 2018년↑ 248건 (최근 철거순)

■ 서울특별시 광진구 자양동 680-63번지
  철거 · 방송통신시설 · 철골콘크리트구조 · 연면적 34,995.78㎡ · 철거 2020-05-02~2020-10-31 ⚠석면(천장·단열·지붕·보온)
■ 서울특별시 광진구 자양동 680-22번지
  철거 · 업무시설 · 철골콘크리트구조 · 연면적 21,558.33㎡ · 철거 2020-05-02~2020-10-31 ⚠석면(천장·보온)
...

"자양동 진행 중인 건축 인허가 보여줘"
→ permits_pipeline(11215, 10500, since_year=2024)

[인허가 파이프라인] 기본개요 5358건 중 진행중(사용승인 전) 1243건 · 허가 2024년↑

■ 서울특별시 광진구 자양동 613-24번지
  신축 · 공동주택 · 연면적 419.12㎡ 12세대 · 허가 2026-04-27 · 단계: 미착공
■ 서울특별시 광진구 자양동 854번지
  발코니구조변경 · 공동주택 · 연면적 52,666.24㎡ 204세대 · 허가 2026-04-22 · 단계: 미착공
...

https://archhub-mcp.fly.dev/mcp

claude mcp add --transport http archhub https://archhub-mcp.fly.dev/mcp

{
  "mcpServers": {
    "archhub": { "type": "http", "url": "https://archhub-mcp.fly.dev/mcp" }
  }
}

{
  "mcpServers": {
    "archhub": { "command": "npx", "args": ["-y", "mcp-remote", "https://archhub-mcp.fly.dev/mcp"] }
  }
}

"광진구 자양동 법정동코드 알려줘"
 → find_region → sigungu=11215, bdong=10500

"자양동 1-1번지 건물 한눈에 보여줘"     → building_profile      # 종합카드
"자양동 건축물 통계 내줘"               → district_stats        # 동 단위 집계
"자양동 40년 넘은 노후 건물 뽑아줘"      → old_buildings         # 노후 선별
"자양동 1-1번지 표제부 원본 보여줘"      → building_ledger(표제부)  # 원천 데이터

광진구 자양동 건축물 노후도랑 용도 구성 통계로 정리해줘     → district_stats
자양동에서 40년 넘은 노후 건물 30개 뽑아줘, 정비사업 검토용이야   → old_buildings
자양동 2018년 이후 철거된 건물 석면 포함해서 보여줘          → demolitions
자양동 지금 진행 중인 건축 인허가 현황 보여줘               → permits_pipeline

자양동 2-2번지 용도지역이랑 건폐율·용적률 현황 한눈에 보여줘   → building_profile
자양동 2-2번지 층별로 무슨 용도가 몇 ㎡씩 있는지 보여줘       → building_floors
자양동 공동주택은 보통 몇 층에 용적률 얼마로 짓나 벤치마크 줘   → district_stats(규모 벤치마크)

자양동 용도별 건물 구성이랑 노후 분포로 사업성 훑어줘        → district_stats
자양동에서 30년 넘은 단독주택 노후 필지 리스트업해줘         → old_buildings
자양동 최근 철거된 필지들 멸실 현황 보여줘                  → demolitions
자양동 허가는 났는데 아직 사용승인 전인 신규 공급 건 보여줘    → permits_pipeline

자양동 2-2번지 건물 스펙 카드로 정리해줘, 손님한테 보여줄거야   → building_profile
자양동 2-2번지 층마다 무슨 업종이 들어와 있어?              → building_floors
자양동 24-28번지 공시가격 최근 몇 년 추이 보여줘            → price_history

자양동 24-28번지 호별 공시가격 연도별 추이랑 상승률 뽑아줘    → price_history
자양동 4-2번지 리버그린 연면적·대지면적·사용승인일 정리해줘    → building_profile
자양동 5-13번지 총괄표제부 원본 보여줘                     → building_ledger(총괄표제부)

git clone https://github.com/chrisryugj/archhub-mcp && cd archhub-mcp
pip install -e .                              # console_scripts 진입점 설치
export ARCHHUB_SERVICE_KEY="<디코딩 인증키>"   # Windows: set 또는 .env.local

archhub-mcp                                   # stdio 모드 (= python -m archhub)
archhub-mcp --transport http --port 8000      # http 모드

ARCHHUB_SERVICE_KEY=... uvx --from . archhub-mcp

claude mcp add archhub -e ARCHHUB_SERVICE_KEY=<디코딩 키> -- archhub-mcp

pip install -e ".[dev]"   # 먼저 설치(안 하면 bare `pytest`는 ModuleNotFoundError)
pytest tests/             # 외부 API 비의존(네트워크 mock) · 65 케이스

fly launch --no-deploy                              # fly.toml 인식
fly secrets set ARCHHUB_SERVICE_KEY="<디코딩 키>"   # 인증키 주입 (평문 커밋 금지)
fly secrets set ARCHHUB_DAILY_CALL_CAP=9000         # (선택) 일일 호출 상한 — 초과 시 차단
fly deploy
fly scale count 1                                   # streamable-http 세션 일관성 위해 단일 머신