realestate-mcp

국토교통부 실거래가 공공데이터(data.go.kr)를 MCP 도구로 제공하는 서버입니다. 아파트/연립다세대/단독다가구/오피스텔의 매매·전월세 실거래가를 지역코드+계약년월로 조회합니다.

제공 도구 (8개)

공통 입력: regionCode(법정동 앞 5자리, 예: 서울 종로구 11110), dealYearMonth(YYYYMM), pageNo(선택), numOfRows(선택, 기본 10)

Related MCP server: naver-land-mcp

설치

npm install
cp .env.example .env   # DATA_GO_KR_SERVICE_KEY 입력
npm run build

설정 (Claude Desktop 예시)

{
  "mcpServers": {
    "realestate": {
      "command": "node",
      "args": ["/절대경로/realestate-mcp/dist/index.js"],
      "env": { "DATA_GO_KR_SERVICE_KEY": "발급받은키" }
    }
  }
}

문서

• 아키텍처/설계: docs/ARCHITECTURE.md

• API별 상세 스펙 요약: docs/api-spec/

• 개발일지(자동 생성): docs/devlog/

개발 참고

Claude Code로 작업 시 CLAUDE.md를 먼저 읽으세요. 토큰 절약을 위한 작업 규칙이 정리되어 있습니다.