# 대한민국 주택개발 조사 MCP

국가법령정보, 국토교통부 건축HUB, KOSIS를 하나의 MCP 서버로 연결합니다.

## 인증값 입력

1. `.env.example`을 복사해 같은 폴더에 `.env` 파일을 만듭니다.
2. 아래 세 값을 `.env`에 직접 입력합니다.

```dotenv
DATA_GO_KR_SERVICE_KEY=공공데이터포털_일반인증키
LAW_OPEN_API_OC=국가법령정보_OC인증값
KOSIS_API_KEY=KOSIS_인증키
```

인증값은 따옴표 없이 입력합니다. `DATA_GO_KR_SERVICE_KEY`는 공공데이터포털의
일반 인증키의 인코딩 키와 디코딩 키를 모두 지원합니다.

## 설치 및 로컬 실행

```powershell
cd "국토교통부MCP 프로젝트"
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt
python server.py
```

기본 MCP 주소는 `http://127.0.0.1:8000/mcp`입니다. ChatGPT 원격 커넥터는
localhost에 접근할 수 없으므로 실제 연결에는 HTTPS 공개 배포가 필요합니다.

## Render 무료 배포

프로젝트 루트의 `render.yaml`은 Render 무료 Web Service 설정입니다.

1. 이 프로젝트를 GitHub 저장소에 올립니다. `.env`는 절대 올리지 않습니다.
2. Render에서 `New > Blueprint`를 선택하고 GitHub 저장소를 연결합니다.
3. 환경변수 입력 화면에서 아래 세 값을 입력합니다.
   - `DATA_GO_KR_SERVICE_KEY`
   - `LAW_OPEN_API_OC`
   - `KOSIS_API_KEY`
4. 배포 완료 후 `https://서비스명.onrender.com/mcp`를 MCP 주소로 사용합니다.

무료 서비스는 15분 동안 요청이 없으면 중지되며 첫 요청 시 다시 시작하는 데
약 1분이 걸릴 수 있습니다. 커넥터 생성 전에 서비스 URL을 한 번 연 다음 1분 정도
기다리고 등록하면 초기 연결 실패를 줄일 수 있습니다.

## 제공 도구

- `search_laws`: 법령·판례·자치법규 검색
- `get_law_text`: 법령 등 본문 조회
- `get_building_title`: 건축물대장 표제부
- `get_building_floors`: 층별개요
- `get_building_zones`: 건축물대장의 지역·지구·구역
- `get_kosis_statistics`: KOSIS 통계자료
- `server_status`: 비밀값을 노출하지 않는 설정 점검

## 주의

- 건축물대장의 지역·지구·구역 정보는 토지이용계획확인서 전체를 대체하지 않습니다.
- 특정 필지를 조회하려면 정확한 법정동코드, 본번, 부번이 필요합니다.
- MCP 결과에 없는 값은 추정하거나 다른 필지 정보로 보완하지 않아야 합니다.