⚠️ サービス終了のお知らせ 本MCPサーバーは2026-08-23をもってfly.ioへのデプロイを終了しました。 コードは開発参考用としてリポジトリに残しています。

realestate-mcp

国土交通部の実取引価格公共データ(data.go.kr)をMCP ツールとして提供するサーバーです。アパート/連立多世帯/単独多世帯/オフィステルの売買・賃貸 実取引価格を地域コード+契約年月で照会します。

提供ツール(8個)

共通入力: regionCode(法定洞の先頭5桁、例: ソウル鍾路区 11110)、dealYearMonth(YYYYMM)、 pageNo(任意)、numOfRows(任意、デフォルト10)

Related MCP server: naver-land-mcp

デプロイ

Fly.ioにHTTP(streamable)MCPサーバーとしてデプロイされています: https://realestate-mcp-hlucent.fly.dev/mcp

サーバーが独自のdata.go.kr認証キーを使用するため、別途の?key=パラメータなしで上記アドレスに 直接接続できます。(過去の?key=本人_認証キー方式はもう使用しません。)

同じIPからの過剰な呼び出しを防ぐため、レート制限が適用されています (毎分3回、24時間30回を超えると429)。一般的な対話型利用には支障ありません。

ローカル開発

npm install
cp .env.example .env   # DATA_GO_KR_SERVICE_KEY 입력 (서버가 사용할 자체 인증키)
npm run dev             # http://localhost:8080/mcp

デプロイ環境ではDATA_GO_KR_SERVICE_KEYをFly secretsとして注入します (fly secrets set DATA_GO_KR_SERVICE_KEY=...)。コードには絶対にハードコーディングしません。

ドキュメント

• アーキテクチャ/設計: docs/ARCHITECTURE.md

• API別詳細スペック要約: docs/api-spec/

• 開発日誌(自動生成): docs/devlog/

開発参考

Claude Codeで作業する際はCLAUDE.mdを先に読んでください。トークン節約のための作業ルールがまとめられています。