Korea Housing

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

인증값 입력

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

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

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

설치 및 로컬 실행

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 결과에 없는 값은 추정하거나 다른 필지 정보로 보완하지 않아야 합니다.