LH Notice MCP Server

한국토지주택공사(LH) 임대주택 분양 공고 정보를 조회하는 MCP(Model Context Protocol) 서버입니다.

소개

이 MCP 서버는 한국토지주택공사(LH)의 공식 API를 통해 다음과 같은 공고 정보를 Claude AI가 조회할 수 있도록 합니다:

• 🏠 임대주택 - 국민임대, 영구임대, 행복주택 등
• 🏢 분양주택 - 보금자리주택, 공공분양 등
• 🏗️ 토지분양 - 택지개발지구 토지분양
• 💑 신혼희망타운 - 신혼부부 특화 주택
• 🏪 상가분양 - 상업시설 분양
• 🤝 주거복지 - 취약계층 지원 주택

설치

npm으로 설치

npm install -g lh-notice-mcp-server

소스코드에서 빌드

git clone https://github.com/yourusername/lh-notice-mcp-server.git
cd lh-notice-mcp-server
npm install
npm run build

설정

Claude Desktop에서 사용하려면 설정 파일을 수정하세요:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "lh-notice": {
      "command": "npx",
      "args": ["lh-notice-mcp-server"]
    }
  }
}

또는 로컬 설치한 경우:

{
  "mcpServers": {
    "lh-notice": {
      "command": "node",
      "args": ["/path/to/lh-notice-mcp-server/dist/index.js"]
    }
  }
}

사용법

Claude Desktop에서 자연어로 요청하세요:

"서울 지역의 최근 임대주택 공고를 조회해주세요"
"경기도 신혼희망타운 분양 정보를 알려주세요"
"부산의 공고중인 분양주택 20개를 보여주세요"
"올해 대전 지역의 주거복지 공고를 찾아주세요"

API 매개변수

필수 매개변수

• PAN_NT_ST_DT: 공고게시일 (YYYY.MM.DD)
• CLSG_DT: 공고마감일 (YYYY.MM.DD)

선택 매개변수

• PG_SZ: 한 페이지 결과 수 (1-100, 기본값: 10)
• PAGE: 페이지 번호 (기본값: 1)
• PAN_NM: 공고명 (부분 일치 검색)
• UPP_AIS_TP_CD: 공고유형코드
  • 01: 토지
  • 05: 분양주택
  • 06: 임대주택
  • 13: 주거복지
  • 22: 상가
  • 39: 신혼희망타운
• CNP_CD: 지역코드 (11: 서울, 41: 경기 등)
• PAN_SS: 공고상태코드 (공고중, 접수중, 접수마감 등)

응답 데이터

{
  "SS_CODE": "결과코드",
  "RS_DTTM": "출력일시",
  "RNUM": "순번",
  "UPP_AIS_TP_NM": "공고유형명",
  "AIS_TP_CD_NM": "공고세부유형명",
  "PAN_NM": "공고명",
  "CNP_CD_NM": "지역명",
  "PAN_SS": "공고상태",
  "ALL_CNT": "전체조회건수",
  "DTL_URL": "공고상세URL"
}

개발

npm run dev     # 개발 모드
npm run build   # TypeScript 빌드
npm start       # 프로덕션 실행

라이센스

MIT License - 자유롭게 사용, 수정, 배포할 수 있습니다.

기여

이슈 리포트나 Pull Request를 환영합니다!

관련 링크

• LH 공공데이터포털
• Model Context Protocol
• Claude Desktop