busan-essentials

釜山の必須情報 — MCP サーバー

韓国・釜山で、最寄りのトイレ、薬局、無料 WiFi、AED、観光案内所を検索できます。韓国政府のオープンデータに基づく8,680か所の情報を収録しており、すべてのレコードに韓国語と英語の情報があります。

これは何ですか？

Busan Essentials は、旅行者や住民を支援する AI エージェント向けに、「釜山で最寄りの X はどこですか？」という質問に答える MCP（Model Context Protocol）サーバーです。すべてのレコードに韓国語と英語の名前と住所が含まれているため、エージェントはタクシー運転手に韓国語のテキストを、旅行者に英語のテキストを伝えられます。

利用可能なデータ

種類	説明	件数
aed	AED（除細動器）の設置場所	2,799
toilet	全16区にある公衆トイレ	2,487
wifi	無料の公衆 WiFi ホットスポット	1,702
pharmacy	釜山市内の薬局	1,667
tourist_info	観光案内所	25

全16区で8,680か所を収録。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}	2,487件中1,050件
  toilet	{"is_24h": true}	2,487件中839件
  toilet	{"diaper_table": true}	2,487件中433件
  tourist_info	{"english": true}	25件中14件
  tourist_info	{"chinese": true}	25件中13件
  tourist_info	{"japanese": true}	25件中9件

  pharmacy、wifi、aed には使用可能なフィルターがありません。上流のデータソースには施設ごとの差異が記録されていないためです。不明なフィルターキーを指定すると、無視されるのではなく、結果は0件になります。

• 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）。最初の呼び出しで結果がない場合は、範囲を広げてください。都心部は500mでも施設が密集していますが、郊外の区ではまばらです。
• type（任意）：施設の種類を1つに絞ります。省略すると、最も近い施設が検索されます。
• limit（任意）：結果の最大数。1～20（デフォルト：5）

各結果には、検索地点からの直線距離を示す distance_m が含まれています。

get_subway_timetable

まだ利用できません。 時刻表データが読み込まれていないため、どの駅を指定しても呼び出し結果はありません。データが追加されればすぐに使えるよう、ツールは登録されたままです。既知のデータ制限をご覧ください。

submit_feedback

Report missing, wrong, or stale data. Reports are read and acted on: earlier reports about empty English fields led to all 8,680 records being filled.

Parameters:

• category (required): new_data | data_quality | coverage | format | frequency | other
• message (required): What's wrong. Include the place ID when you have one.
• priority (optional): low | medium | high (default: medium)

Quick Start

Option A: Smithery (Recommended)

Visit Busan Essentials on Smithery and follow the setup instructions for your MCP client.

Option B: Direct Connection

Add to your MCP client config (e.g., Claude Desktop claude_desktop_config.json):

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

Option C: Run Locally

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

Example Queries

An AI agent can use these tools to answer questions like:

English

• "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在哪里？"

Feedback

We actively review and incorporate feedback to improve data quality and coverage.

For AI agents: Use the submit_feedback tool during a conversation to report issues or suggest improvements.

For developers: Open a feedback issue on GitHub.

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

Known Data Limitations

• subway: Not loaded. The Humetro timetable API (data.go.kr 15000522) requires a separate usage application that is still pending, so get_subway_timetable returns nothing for every station. The parser and config are in place; the data flows the moment the key is approved. Donghae Line and Busan–Gimhae Light Rail follow later.
• pharmacy: No 24-hour or foreign-language flags. The nationwide E-Gen source does not carry them, so is_24h reads false on all 1,667 records — that is a source gap, not a statement that no 24-hour pharmacy exists in Busan.
• toilet coordinates fall back to the district centroid; the upstream standard dataset dropped its WGS84 columns. wifi, pharmacy, aed, and tourist_info have precise coordinates.
• English names and addresses are generated by Revised Romanization plus a facility-type glossary (미래약국 → "Mirae Pharmacy"). Loanword names romanize phonetically rather than recovering the original spelling (오션약국 → "Osyeon Pharmacy", not "Ocean"). Korean fields are always the authoritative ones.
• tourist_info is 25 records, not 26: the source dataset contains a test entry ("테스트 관광안내소") which is excluded.

Data Sources

All data sourced from official Korean government open data, used under KOGL Type 1 (출처표시 / Attribution):

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

License

• Code — MIT, see LICENSE.
• Data — KOGL Type 1 (공공누리 제1유형 · Attribution), see NOTICE. Commercial use and modification are permitted; the originating portal must be credited.