Busan Essentials — MCP-Server

Finden Sie die nächste Toilette, die nächste Apotheke, den nächsten kostenlosen WLAN-Hotspot, den nächsten AED oder das nächste Touristeninformationszentrum in Busan, Südkorea. 8.680 Orte aus offenen Daten der koreanischen Regierung, jeder Eintrag auf Koreanisch und Englisch.

Was ist das?

Busan Essentials ist ein MCP-Server (Model Context Protocol), der Fragen wie „Wo ist das nächste X in Busan?“ für KI-Agenten beantwortet, die Reisenden und Einwohnern helfen. Jeder Eintrag enthält einen koreanischen und einen englischen Namen sowie eine Adresse, sodass ein Agent den koreanischen Text einem Taxifahrer und den englischen dem Reisenden geben kann.

Related MCP server: OpenAPI Korea MCP Server

Verfügbare Daten

8.680 Orte live in allen 16 Bezirken von Busan, bezogen von data.go.kr. Jeder Eintrag enthält GPS-Koordinaten, Öffnungszeiten, Barrierefreiheitskennzeichen und einen trust_score.

Nicht abgedeckt: U-Bahn- und Busfahrpläne, Taxis, Restaurants, Hotels, Sehenswürdigkeiten und alle Orte außerhalb von Busan. get_subway_timetable ist registriert, hat aber keine geladenen Daten — siehe Bekannte Datenbeschränkungen.

MCP-Tools

find_places

Suchen Sie nach Typ, Bezirk und Attributen. Verwenden Sie stattdessen find_nearby, wenn der Benutzer einen Standort hat oder nach dem nächstgelegenen sucht.

Parameter:

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

• district (optional): Name des Busan-Bezirks auf Englisch oder Koreanisch (z. B. "haeundae", "해운대구")

• filters (optional): Attributfilter, die alle übereinstimmen müssen. Es gibt nur diese:

  Typ	Filter	Übereinstimmende Einträge
  toilet	{"wheelchair": true}	1.050 von 2.487
  toilet	{"is_24h": true}	839 von 2.487
  toilet	{"diaper_table": true}	433 von 2.487
  tourist_info	{"english": true}	14 von 25
  tourist_info	{"chinese": true}	13 von 25
  tourist_info	{"japanese": true}	9 von 25

  pharmacy, wifi und aed haben keinen brauchbaren Filter — die vorgelagerten Quellen erfassen keine Variationen pro Einrichtung. Ein unbekannter Filter-Schlüssel liefert null Ergebnisse, anstatt ignoriert zu werden.

• limit (optional): Maximale Ergebnisse, 1-50 (Standard: 10)

get_place_detail

Rufen Sie den vollständigen Datensatz für eine Einrichtung anhand ihrer ID ab. IDs stammen von find_places oder find_nearby — erraten Sie sie nicht.

Parameter:

• id (erforderlich): Orts-ID (z. B. "toilet_00001", "pharmacy_0538", "aed_00001", "tourist_info_08")

find_nearby

Finden Sie die nächstgelegenen Einrichtungen zu einem GPS-Punkt, sortiert nach Entfernung. Die richtige Standardwahl für „nächstgelegen“, „am nächsten“ oder „hier in der Nähe“ — und für dringende Bedürfnisse.

Parameter:

• lat (erforderlich): Breitengrad (Busan erstreckt sich von ~35,04 bis ~35,40)

• lng (erforderlich): Längengrad (Busan erstreckt sich von ~128,78 bis ~129,30)

• radius_m (optional): Suchradius in Metern, 100-5000 (Standard: 500). Erweitern Sie ihn, wenn der erste Aufruf leer zurückkommt — 500 m sind in der Innenstadt dicht, aber in äußeren Bezirken dünn.

• type (optional): Auf einen Einrichtungstyp beschränken. Wenn Sie nichts angeben, wird das Nächstgelegene zurückgegeben.

• limit (optional): Maximale Ergebnisse, 1-20 (Standard: 5)

Jedes Ergebnis enthält distance_m, die Luftlinienentfernung vom Suchpunkt.

get_subway_timetable

Noch nicht verfügbar. Es sind keine Fahrplandaten geladen, daher gibt jeder Aufruf für jede Station nichts zurück. Das Tool bleibt registriert, sodass es funktioniert, sobald die Daten eintreffen — siehe Bekannte Datenbeschränkungen.

submit_feedback

Melden Sie fehlende, falsche oder veraltete Daten. Meldungen werden gelesen und umgesetzt: Frühere Meldungen über leere englische Felder führten dazu, dass alle 8.680 Einträge ausgefüllt wurden.

Parameter:

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

• message (erforderlich): Was falsch ist. Geben Sie die Orts-ID an, wenn Sie eine haben.

• priority (optional): low | medium | high (Standard: medium)

Schnellstart

Option A: Smithery (Empfohlen)

Besuchen Sie Busan Essentials auf Smithery und folgen Sie den Einrichtungsanweisungen für Ihren MCP-Client.

Option B: Direkte Verbindung

Fügen Sie Folgendes zur Konfiguration Ihres MCP-Clients hinzu (z. B. Claude Desktop claude_desktop_config.json):

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

Option C: Lokal ausführen

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

Beispielabfragen

Ein KI-Agent kann diese Tools verwenden, um Fragen wie die folgenden zu beantworten:

Englisch

• "Finden Sie eine Apotheke in der Nähe des Bahnhofs Seomyeon"

• "Wo ist die nächste öffentliche Toilette am Haeundae-Strand?"

• "Ich brauche eine rollstuhlgerechte Toilette in Haeundae, die 24 Stunden geöffnet ist"

• "Finden Sie kostenlose WLAN-Hotspots im Bereich Gwangalli"

• "Wo ist der nächste AED in der Nähe von Nampo-dong?"

• "Welches Touristeninformationszentrum in meiner Nähe hat englischsprachiges Personal?"

日本語

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

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

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

中文

• "在西面附近找药店"

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

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

Feedback

Wir prüfen Feedback aktiv und arbeiten es ein, um die Datenqualität und -abdeckung zu verbessern.

Für KI-Agenten: Verwenden Sie das Tool submit_feedback während eines Gesprächs, um Probleme zu melden oder Verbesserungen vorzuschlagen.

Für Entwickler: Eröffnen Sie ein Feedback-Problem auf GitHub.

Kategorien: new_data | data_quality | coverage | format | frequency | other

Bekannte Datenbeschränkungen

• subway: Nicht geladen. Die Humetro-Fahrplan-API (data.go.kr 15000522) erfordert einen separaten Nutzungsantrag, der noch aussteht. Daher gibt get_subway_timetable für jede Station nichts zurück. Parser und Konfiguration sind vorhanden; die Daten fließen, sobald der Schlüssel genehmigt ist. Donghae Line und Busan–Gimhae Light Rail folgen später.

• pharmacy: Keine 24-Stunden- oder Fremdsprachen-Kennzeichen. Die landesweite E-Gen-Quelle enthält sie nicht, daher liest is_24h bei allen 1.667 Datensätzen false — das ist eine Lücke in der Quelle und keine Aussage, dass es in Busan keine 24-Stunden-Apotheke gibt.

• toilet-Koordinaten fallen auf den Bezirksschwerpunkt zurück; das vorgelagerte Standarddatenset hat seine WGS84-Spalten entfernt. wifi, pharmacy, aed und tourist_info haben präzise Koordinaten.

• Englische Namen und Adressen werden durch Revised Romanization plus ein Glossar für Einrichtungstypen erzeugt (미래약국 → "Mirae Pharmacy"). Lehnwörter werden phonetisch romanisiert, anstatt die ursprüngliche Schreibweise wiederherzustellen (오션약국 → "Osyeon Pharmacy", nicht "Ocean"). Koreanische Felder sind immer die maßgeblichen.

• tourist_info umfasst 25 Datensätze, nicht 26: Das Quelldatenset enthält einen Testeintrag ("테스트 관광안내소"), der ausgeschlossen ist.

Datenquellen

Alle Daten stammen aus offiziellen offenen Daten der koreanischen Regierung, verwendet unter KOGL Type 1 (출처표시 / Attribution):

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

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

Lizenz

• Code — MIT, siehe LICENSE.

• Daten — KOGL Type 1 (공공누리 제1유형 · Attribution), siehe NOTICE. Kommerzielle Nutzung und Bearbeitung sind gestattet; das Ursprungsportal muss angegeben werden.