realestate-mcp
Provides South Korean real estate transaction price lookup (sales and rent) for apartments, row houses, single-family homes, and officetels via MCP tools using public data from data.go.kr.
README
realestate-mcp
국토교통부 실거래가 공공데이터(data.go.kr)를 MCP 도구로 제공하는 서버입니다. 아파트/연립다세대/단독다가구/오피스텔의 매매·전월세 실거래가를 지역코드+계약년월로 조회합니다.
제공 도구 (8개)
| 도구명 | 설명 |
|---|---|
get_apt_trade |
아파트 매매 실거래가 |
get_apt_rent |
아파트 전월세 실거래가 |
get_sh_trade |
단독/다가구 매매 실거래가 |
get_sh_rent |
단독/다가구 전월세 실거래가 |
get_rh_trade |
연립다세대 매매 실거래가 |
get_rh_rent |
연립다세대 전월세 실거래가 |
get_offi_trade |
오피스텔 매매 실거래가 |
get_offi_rent |
오피스텔 전월세 실거래가 |
공통 입력: regionCode(법정동 앞 5자리, 예: 서울 종로구 11110), dealYearMonth(YYYYMM),
pageNo(선택), numOfRows(선택, 기본 10)
배포
Fly.io에 HTTP(streamable) MCP 서버로 배포되어 있습니다: https://realestate-mcp-hlucent.fly.dev/mcp
serviceKey는 서버에 저장하지 않고, 요청마다 ?key= 쿼리 파라미터로 본인의
data.go.kr 인증키를 전달합니다 (seoul-air-quality-mcp, construction-alert-mcp와 동일한 방식).
https://realestate-mcp-hlucent.fly.dev/mcp?key=본인의_data.go.kr_인증키
키 발급: https://www.data.go.kr → 회원가입 → 국토교통부_실거래가 자료 API별 활용신청 → 인증키 확인
로컬 개발
npm install
cp .env.example .env # DATA_GO_KR_SERVICE_KEY 입력 (통합 테스트 스크립트용)
npm run dev # http://localhost:8080/mcp
MCP 클라이언트 설정 시에도 배포와 동일하게 URL의 ?key=로 인증키를 전달합니다
(서버 프로세스 환경변수로는 주입하지 않음).
문서
- 아키텍처/설계:
docs/ARCHITECTURE.md - API별 상세 스펙 요약:
docs/api-spec/ - 개발일지(자동 생성):
docs/devlog/
개발 참고
Claude Code로 작업 시 CLAUDE.md를 먼저 읽으세요. 토큰 절약을 위한 작업 규칙이 정리되어 있습니다.
Recommended Servers
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.
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.
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.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
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.
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.
Neon Database
MCP server for interacting with Neon Management API and databases
E2B
Using MCP to run code via e2b.
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.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.