⚠️ Уведомление о прекращении обслуживания Данный MCP-сервер прекратил развертывание на fly.io с 2026-08-23. Код оставлен в репозитории для справочных целей при разработке.

realestate-mcp

Сервер, предоставляющий публичные данные о реальных ценах сделок Министерства земли, инфраструктуры и транспорта (data.go.kr) в качестве инструментов MCP. Осуществляет поиск реальных цен сделок купли-продажи и аренды (с залогом/без залога) для квартир, многоквартирных домов (таунхаусов), отдельно стоящих/многоквартирных домов и офисов по коду региона + году и месяцу договора.

Предоставляемые инструменты (8 шт.)

Общие входные параметры: regionCode (первые 5 цифр юридического округа, напр. Сеул, Чонно-гу 11110), dealYearMonth (ГГГГММ), 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 раза в минуту, при превышении 30 раз за 24 часа возвращается 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. Там описаны правила работы для экономии токенов.