# 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` | 지역지구구역 | 용도지역, 재건축 판단용 |

## 설치 및 실행

### 사전 준비

[공공데이터포털](https://www.data.go.kr/data/15134735/openapi.do)에서 "건축물대장정보 서비스" API 키를 발급받으세요.

### Claude Desktop

`claude_desktop_config.json`에 추가:

```json
{
  "mcpServers": {
    "building-register": {
      "command": "npx",
      "args": ["building-register-mcp"],
      "env": {
        "DATA_GO_KR_API_KEY": "발급받은_API_키"
      }
    }
  }
}
```

### Claude Code

```bash
claude mcp add building-register -- npx building-register-mcp
```

환경변수 설정:

```bash
DATA_GO_KR_API_KEY=발급받은_API_키 npx building-register-mcp
```

### 직접 실행

```bash
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) |

## 응답 예시

```json
{"total_count":"32","items":[{"건물명":"개포자이","도로명주소":"서울특별시 강남구 개포로109길 69","용적률":250.64,"건폐율":18.91,"대지면적":15487.3,"건축면적":2927.93,"연면적":60400.03,"세대수":212,"주용도":"공동주택","총주차수":501,"사용승인일":"20040617"}]}
```

## API 원본

- [국토교통부 건축HUB 건축물대장정보 서비스 (공공데이터포털)](https://www.data.go.kr/data/15134735/openapi.do)

## 라이선스

MIT