Busan Essentials — MCP-сервер

Найдите ближайший туалет, аптеку, бесплатный WiFi, AED или туристический информационный центр в Пусане, Южная Корея. 8,680 объектов из открытых данных правительства Кореи, каждая запись на корейском и английском языках.

Что это?

Busan Essentials — это MCP-сервер (Model Context Protocol), который отвечает на вопрос «где ближайший X в Пусане?» для ИИ-агентов, помогающих туристам и местным жителям. Каждая запись содержит название и адрес на корейском и английском языках, поэтому агент может передать корейский текст таксисту, а английский — путешественнику.

Related MCP server: OpenAPI Korea MCP Server

Доступные данные

8,680 активных объектов во всех 16 районах Пусана, данные с data.go.kr. Каждая запись содержит GPS-координаты, часы работы, флаги доступности и trust_score.

Не охвачено: расписания метро и автобусов, такси, рестораны, отели, достопримечательности и всё, что за пределами Пусана. get_subway_timetable зарегистрирован, но в нём нет данных — см. Известные ограничения данных.

Инструменты MCP

find_places

Поиск по типу, району и атрибутам. Используйте find_nearby, если у пользователя есть местоположение или он спрашивает про ближайший объект.

Параметры:

• type (обязательный): "toilet" | "pharmacy" | "wifi" | "aed" | "tourist_info"

• district (необязательный): название района Пусана на английском или корейском (например, "haeundae", "해운대구")

• filters (необязательный): фильтры по атрибутам, все должны совпадать. Существуют только следующие:

  Тип	Фильтр	Совпадающих записей
  toilet	{"wheelchair": true}	1,050 из 2,487
  toilet	{"is_24h": true}	839 из 2,487
  toilet	{"diaper_table": true}	433 из 2,487
  tourist_info	{"english": true}	14 из 25
  tourist_info	{"chinese": true}	13 из 25
  tourist_info	{"japanese": true}	9 из 25

  pharmacy, wifi и aed не имеют полезных фильтров — в исходных данных нет различий между объектами. Неизвестный ключ фильтра возвращает ноль результатов, а не игнорируется.

• limit (необязательный): максимум результатов, 1-50 (по умолчанию: 10)

get_place_detail

Получите полную запись об одном объекте по его ID. ID берутся из find_places или find_nearby — не угадывайте их.

Параметры:

• id (обязательный): ID места (например, "toilet_00001", "pharmacy_0538", "aed_00001", "tourist_info_08")

find_nearby

Находит ближайшие объекты к точке GPS, отсортированные по расстоянию. Подходит по умолчанию для запросов «ближайший», «самый близкий» или «здесь рядом» — а также для срочных нужд.

Параметры:

• lat (обязательный): широта (Пусан находится в диапазоне ~35.04 – ~35.40)

• lng (обязательный): долгота (Пусан находится в диапазоне ~128.78 – ~129.30)

• radius_m (необязательный): радиус поиска в метрах, 100-5000 (по умолчанию: 500). Увеличьте его, если первый вызов вернул пустой результат — 500 м достаточно в центре города, но мало в отдалённых районах.

• type (необязательный): ограничение по типу объекта. Если не указано, вернётся то, что ближе всего.

• limit (необязательный): максимум результатов, 1-20 (по умолчанию: 5)

Каждый результат содержит distance_m — расстояние по прямой от точки поиска.

get_subway_timetable

Пока недоступно. Данные расписания не загружены, поэтому каждый вызов возвращает пустой результат для каждой станции. Инструмент остаётся зарегистрированным, поэтому он заработает сразу после появления данных — см. Известные ограничения данных.

submit_feedback

Сообщите об отсутствующих, неверных или устаревших данных. Сообщения читаются и учитываются: более ранние сообщения о пустых англоязычных полях привели к заполнению всех 8,680 записей.

Параметры:

• category (обязательный): new_data | data_quality | coverage | format | frequency | other

• message (обязательный): что не так. Укажите ID места, если он у вас есть.

• priority (необязательный): low | medium | high (по умолчанию: medium)

Быстрый старт

Вариант A: Smithery (рекомендуется)

Посетите Busan Essentials на Smithery и следуйте инструкциям по настройке для вашего MCP-клиента.

Вариант B: Прямое подключение

Добавьте в конфигурацию вашего MCP-клиента (например, Claude Desktop claude_desktop_config.json):

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

Вариант C: Локальный запуск

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

Примеры запросов

ИИ-агент может использовать эти инструменты для ответа на такие вопросы, как:

Английский

• «Найди аптеку рядом со станцией Сомён»

• «Где ближайший общественный туалет к пляжу Хэундэ?»

• «Мне нужен туалет, доступный для инвалидных колясок, в Хэундэ, работающий круглосуточно»

• «Найди бесплатные точки WiFi в районе Кваналли»

• «Где ближайший AED к Нампо-дону?»

• «Какой туристический информационный центр рядом со мной имеет англоговорящий персонал?»

日本語

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

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

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

中文

• "在西面附近找药店"

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

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

Обратная связь

Мы активно рассматриваем и учитываем обратную связь для улучшения качества и полноты данных.

Для ИИ-агентов: используйте инструмент submit_feedback во время разговора, чтобы сообщить о проблемах или предложить улучшения.

Для разработчиков: Откройте issue с обратной связью на GitHub.

Категории: new_data | data_quality | coverage | format | frequency | other

Известные ограничения данных

• subway: Не загружено. API расписания Humetro (data.go.kr 15000522) требует отдельной заявки на использование, которая ещё ожидает рассмотрения, поэтому get_subway_timetable ничего не возвращает ни для одной станции. Парсер и конфигурация готовы; данные появятся сразу после одобрения ключа. Линия Тонхэ и Busan–Gimhae Light Rail будут добавлены позже.

• pharmacy: Нет флагов круглосуточной работы или иностранных языков. Общенациональный источник E-Gen их не содержит, поэтому is_24h равен false во всех 1,667 записях — это пробел в источнике, а не утверждение, что в Пусане нет круглосуточных аптек.

• Координаты toilet возвращаются к центроиду района; исходный стандартный набор данных потерял колонки WGS84. wifi, pharmacy, aed и tourist_info имеют точные координаты.

• Английские названия и адреса создаются с использованием системы Revised Romanization и глоссария типов объектов (미래약국 → "Mirae Pharmacy"). Названия-заимствования романизируются фонетически, а не восстанавливают исходное написание (오션약국 → "Osyeon Pharmacy", а не "Ocean"). Корейские поля всегда являются авторитетными.

• tourist_info содержит 25 записей, а не 26: в исходном наборе данных есть тестовая запись ("테스트 관광안내소"), которая исключена.

Источники данных

Все данные взяты из официальных открытых данных правительства Кореи и используются по лицензии KOGL Type 1 (출처표시 / Attribution):

• Korea Open Data Portal (data.go.kr)

• Busan Open Data Portal (data.busan.go.kr)

Лицензия

• Код — MIT, см. LICENSE.

• Данные — KOGL Type 1 (공공누리 제1유형 · Attribution), см. NOTICE. Разрешены коммерческое использование и модификация; необходимо указывать исходный портал.