Busan Essentials — MCP Server

Encuentra el aseo, la farmacia, el WiFi gratuito, el AED o el centro de información turística más cercano en Busan, Corea del Sur. 8.680 lugares de datos abiertos del gobierno coreano, cada registro tanto en coreano como en inglés.

¿Qué es esto?

Busan Essentials es un servidor MCP (Model Context Protocol) que responde «¿dónde está la X más cercana en Busan?» para agentes de IA que ayudan a viajeros y residentes. Cada registro incluye un nombre y una dirección en coreano e inglés, de modo que un agente puede darle el texto en coreano a un taxista y el texto en inglés al viajero.

Related MCP server: OpenAPI Korea MCP Server

Datos disponibles

8.680 lugares activos en los 16 distritos de Busan, procedentes de data.go.kr. Cada registro tiene coordenadas GPS, horario de apertura, indicadores de accesibilidad y un trust_score.

No incluidos: horarios de metro y autobús, taxis, restaurantes, hoteles, atracciones y cualquier lugar fuera de Busan. get_subway_timetable está registrado pero no tiene datos cargados — consulta Limitaciones de datos conocidas.

Herramientas MCP

find_places

Busca por tipo, distrito y atributos. Usa find_nearby en su lugar cuando el usuario tenga una ubicación o pida la más cercana.

Parámetros:

• type (obligatorio): "toilet" | "pharmacy" | "wifi" | "aed" | "tourist_info"

• district (opcional): nombre del distrito de Busan en inglés o coreano (p. ej., "haeundae", "해운대구").

• filters (opcional): filtros de atributos, todos deben coincidir. Solo existen estos:

pharmacy, wifi y aed no tienen ningún filtro utilizable: las fuentes originales no registran variaciones por instalación. Una clave de filtro desconocida devuelve cero resultados en lugar de ignorarse.

• limit (opcional): máximo de resultados, 1-50 (predeterminado: 10).

get_place_detail

Obtén el registro completo de una instalación por su ID. Los ID provienen de find_places o find_nearby; no los adivines.

Parámetros:

• id (obligatorio): ID del lugar (p. ej., "toilet_00001", "pharmacy_0538", "aed_00001", "tourist_info_08").

find_nearby

Encuentra las instalaciones más cercanas a un punto GPS, ordenadas por distancia. La opción correcta por defecto para "más cercano", "más próximo" o "por aquí", y para necesidades urgentes.

Parámetros:

• lat (obligatorio): latitud (Busan abarca entre ~35.04 y ~35.40).

• lng (obligatorio): longitud (Busan abarca entre ~128.78 y ~129.30).

• radius_m (opcional): radio de búsqueda en metros, 100-5000 (predeterminado: 500). Amplíalo si la primera llamada vuelve vacía: 500 m es denso en el centro, pero escaso en los distritos exteriores.

• type (opcional): restringe a un tipo de instalación. Omítelo para obtener lo que esté más cerca.

• limit (opcional): máximo de resultados, 1-20 (predeterminado: 5).

Cada resultado incluye distance_m, la distancia en línea recta desde el punto de búsqueda.

get_subway_timetable

Aún no disponible. No hay datos de horarios cargados, por lo que cada llamada no devuelve nada para ninguna estación. La herramienta permanece registrada para que empiece a funcionar en cuanto lleguen los datos; consulta Limitaciones de datos conocidas.

submit_feedback

Informa sobre datos faltantes, incorrectos o desactualizados. Los informes se leen y se actúa sobre ellos: los informes anteriores sobre campos en inglés vacíos hicieron que se completaran los 8.680 registros.

Parámetros:

• category (obligatorio): new_data | data_quality | coverage | format | frequency | other

• message (obligatorio): qué está mal. Incluye el ID del lugar cuando tengas uno.

• priority (opcional): low | medium | high (predeterminado: medium)

Inicio rápido

Opción A: Smithery (Recomendada)

Visita Busan Essentials en Smithery y sigue las instrucciones de configuración para tu cliente MCP.

Opción B: Conexión directa

Añádelo a la configuración de tu cliente MCP (p. ej., Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "busan-essentials": {
      "url": "https://busan-essentials-mcp-85013349489.asia-northeast3.run.app/mcp"
    }
  }
}

Opción C: Ejecutar localmente

git clone https://github.com/do-droid/busan-essentials.git
cd busan-essentials
API_BASE_URL="https://asia-northeast3-busan-essentials.cloudfunctions.net/api" \
uv run python -m src.server

Consultas de ejemplo

Un agente de IA puede usar estas herramientas para responder preguntas como:

Inglés

• "Find a pharmacy near Seomyeon Station"

• "Where is the nearest public restroom to Haeundae Beach?"

• "I need a wheelchair-accessible restroom in Haeundae that's open 24 hours"

• "Find free WiFi hotspots in Gwangalli area"

• "Where is the closest AED to Nampo-dong?"

• "Which tourist information center near me has English-speaking staff?"

日本語

• 「西面（ソミョン）で薬局を探して」

• 「広安里（クァンアルリ）の近くで無料Wi-Fiが使える場所は？」

• 「海雲台（ヘウンデ）駅周辺の公衆トイレを教えて」

中文

• "在西面附近找药店"

• "广安里附近哪里有免费WiFi？"

• "南浦洞附近最近的AED在哪里？"

Comentarios

Revisamos e incorporamos activamente los comentarios para mejorar la calidad y la cobertura de los datos.

Para agentes de IA: usa la herramienta submit_feedback durante una conversación para informar de problemas o sugerir mejoras.

Para desarrolladores: abre una incidencia de comentarios en GitHub.

Categorías: new_data | data_quality | coverage | format | frequency | other

Limitaciones de datos conocidas

• subway: no cargado. La API de horarios de Humetro (data.go.kr 15000522) requiere una solicitud de uso aparte que aún está pendiente, por lo que get_subway_timetable no devuelve nada para ninguna estación. El analizador y la configuración están listos; los datos fluyen en cuanto se apruebe la clave. La línea Donghae y el tren ligero Busan–Gimhae llegarán más adelante.

• pharmacy: no tiene indicadores de 24 horas ni de idiomas extranjeros. La fuente nacional E-Gen no los incluye, por lo que is_24h se lee como false en los 1.667 registros; eso es una carencia de la fuente, no una afirmación de que no exista ninguna farmacia de 24 horas en Busan.

• Las coordenadas de toilet se sustituyen por el centroide del distrito; el conjunto de datos estándar original eliminó sus columnas WGS84. wifi, pharmacy, aed y tourist_info tienen coordenadas precisas.

• Los nombres y direcciones en inglés se generan mediante la romanización revisada más un glosario de tipos de instalación (미래약국 → "Mirae Pharmacy"). Los nombres de préstamo se romanizan fonéticamente en lugar de recuperar la ortografía original (오션약국 → "Osyeon Pharmacy", no "Ocean"). Los campos en coreano son siempre los que tienen autoridad.

• tourist_info tiene 25 registros, no 26: el conjunto de datos original contiene una entrada de prueba ("테스트 관광안내소") que está excluida.

Fuentes de datos

Todos los datos proceden de datos abiertos oficiales del gobierno coreano, utilizados bajo KOGL Type 1 (출처표시 / Atribución):

• Portal de Datos Abiertos de Corea (data.go.kr)

• Portal de Datos Abiertos de Busan (data.busan.go.kr)

Licencia

• Código — MIT, consulta LICENSE.

• Datos — KOGL Type 1 (공공누리 제1유형 · Atribución), consulta NOTICE. Se permiten el uso comercial y la modificación; debe acreditarse al portal de origen.