⚠️ Aviso de cierre del servicio Este servidor MCP finalizó su despliegue en fly.io el 2026-08-23. El código se conserva en el repositorio como referencia de desarrollo.

realestate-mcp

Es un servidor que proporciona los datos públicos de precios de transacciones reales del Ministerio de Territorio, Infraestructura y Transporte (data.go.kr) como herramientas MCP. Consulta los precios de transacciones reales de compraventa y arrendamiento (jeonse/mensual) de apartamentos, casas adosadas/multifamiliares, viviendas unifamiliares/multifamiliares y oficinas mediante código de región + año/mes de contrato.

Herramientas proporcionadas (8)

Entrada común: regionCode (primeros 5 dígitos del código de distrito legal, ej.: Jongno-gu, Seúl 11110), dealYearMonth (AAAAMM), pageNo (opcional), numOfRows (opcional, 10 por defecto)

Related MCP server: naver-land-mcp

Despliegue

Está desplegado como servidor MCP HTTP (transmisible) en Fly.io: https://realestate-mcp-hlucent.fly.dev/mcp

Como el servidor utiliza su propia clave de autenticación de data.go.kr, puede conectarse directamente a la dirección anterior sin un parámetro ?key= adicional. (El método anterior de ?key=su_propia_clave ya no se utiliza.)

Se aplica un límite de frecuencia para evitar llamadas excesivas desde la misma IP (3 veces por minuto, 429 si supera 30 veces en 24 horas). No afecta el uso conversacional normal.

Desarrollo local

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

En el entorno de despliegue, DATA_GO_KR_SERVICE_KEY se inyecta mediante Fly secrets (fly secrets set DATA_GO_KR_SERVICE_KEY=...). Nunca se codifica directamente en el código.

Documentación

• Arquitectura/diseño: docs/ARCHITECTURE.md

• Resumen de especificaciones detalladas por API: docs/api-spec/

• Registro de desarrollo (generado automáticamente): docs/devlog/

Referencia de desarrollo

Al trabajar con Claude Code, lea primero CLAUDE.md. Allí se recogen las reglas de trabajo para ahorrar tokens.