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","거래유형":"중개거래","매도자":"개인","매수자":"개인"}]}

API 원본

• 국토교통부 아파트 매매 실거래가 자료 (공공데이터포털)

라이선스

MIT