rtms-mcp

0 starsCommunity

Install to Claude Code

This server doesn't publish a one-line install command. Follow the setup in the source repository.

Summary

Queries Korean apartment sale transaction data (RTMS) by region code and contract date. Optimized for token efficiency with compressed JSON and Korean field names.

README.md

rtms-mcp

한국 아파트 매매 실거래가(국토교통부 RTMS) 데이터를 조회하는 MCP 서버입니다.

특징

토큰 절약: 한글 필드명 변환, 공백 없는 압축 JSON, 필요 필드만 반환
간편 사용: 도구 1개, 파라미터 2개(지역코드 + 계약년월)만으로 조회

조회 가능 데이터

아파트 매매 실거래가: 단지명, 전용면적, 거래금액, 층, 건축년도, 거래유형, 매도자/매수자 구분 등

설치 및 실행

사전 준비

공공데이터포털에서 "아파트 매매 실거래가 자료" API 키를 발급받으세요.

Claude Desktop

claude_desktop_config.json에 추가:

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

Claude Code

claude mcp add rtms -- npx rtms-mcp

직접 실행

DATA_GO_KR_API_KEY=발급받은_API_키 npx rtms-mcp

파라미터

| 파라미터 | 필수 | 설명 | |----------|:----:|------| | lawd_cd | O | 지역코드 (법정동코드 앞 5자리) | | deal_ymd | O | 계약년월 (YYYYMM 6자리) | | num_of_rows | | 결과 수 (기본 20) | | page_no | | 페이지 번호 (기본 1) |

응답 예시

{"total_count":50,"items":[{"지역코드":"11680","법정동":"역삼동","단지명":"역삼래미안","전용면적":"84.92","거래금액만원":"230,000","층":"12","건축년도":"2004","거래유형":"중개거래","매도자":"개인","매수자":"개인"}]}