korea-realestate-mcp

korea-realestate-mcp

Enables AI agents to query and analyze Korean apartment real estate transaction prices (sales and rentals) using natural language, providing tools for price trends, regional comparisons, and rent ratios.

Category
Visit Server

README

korea-realestate-mcp

한국 부동산(아파트) 실거래가 조회 및 분석을 위한 MCP(Model Context Protocol) 서버입니다.

AI 에이전트(Claude Desktop, Cursor, Claude Code 등)에서 자연어로 아파트 매매/전월세 시세를 조회하고 분석할 수 있습니다.

한국 부동산 데이터를 제공하는 최초의 MCP 서버입니다.

제공 도구

도구 설명
realestate_search_apt_trade 아파트 매매 실거래가 조회
realestate_search_apt_rent 아파트 전월세 실거래가 조회
realestate_get_region_code 지역명 → 법정동 코드 조회 (퍼지 매칭)
realestate_analyze_price_trend 시세 추이 분석 (월별 통계, 변동률)
realestate_compare_regions 2~5개 지역 시세 비교
realestate_analyze_rent_ratio 매매가 대비 전세가율 분석
realestate_get_apt_summary 특정 아파트 단지 종합 요약

설치

uvx (권장)

uvx korea-realestate-mcp

pip

pip install korea-realestate-mcp

설정

1. API 키 발급

공공데이터포털에서 회원가입 후 아래 API의 활용 신청을 합니다:

  • 국토교통부_아파트매매 실거래자료 (링크)
  • 국토교통부_아파트 전월세 자료 (링크)

신청 즉시 승인되며, 마이페이지에서 **서비스 키(Decoding)**를 복사합니다.

2. Claude Desktop 설정

claude_desktop_config.json에 아래를 추가합니다:

{
  "mcpServers": {
    "korea-realestate": {
      "command": "uvx",
      "args": ["korea-realestate-mcp"],
      "env": {
        "PUBLIC_DATA_API_KEY": "<발급받은 서비스 키>"
      }
    }
  }
}

3. Claude Code 설정

export PUBLIC_DATA_API_KEY="<발급받은 서비스 키>"
claude mcp add korea-realestate -- uvx korea-realestate-mcp

사용 시나리오

1. 아파트 시세 조회

"강남구 아파트 최근 시세 알려줘"

realestate_search_apt_trade가 호출되어 최근 거래 내역을 Markdown 테이블로 반환합니다.

2. 특정 단지 시세 추이

"래미안대치팰리스 84㎡ 최근 1년 시세 추이 보여줘"

realestate_analyze_price_trend가 월별 평균가, 변동률, 거래량을 분석합니다.

3. 지역 비교

"분당 vs 일산 아파트 가격 비교해줘"

realestate_compare_regions가 지역별 평균가, 중앙값, ㎡당 단가를 비교합니다.

4. 전세가율 분석

"분당 전세가율 어때?"

realestate_analyze_rent_ratio가 매매가 대비 전세가율과 갭투자 금액을 산출합니다.

5. 단지 종합 정보

"판교 힐스테이트 종합 정보"

realestate_get_apt_summary가 최근 거래, 면적대별 시세, 전세가율을 요약합니다.

데이터 출처

기술 스택

  • Python 3.10+
  • FastMCP (MCP Python SDK)
  • httpx (비동기 HTTP)
  • SQLite 캐시 (aiosqlite)
  • pandas (데이터 분석)

라이선스

MIT

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured