Busan Essentials — MCPサーバー

韓国・釜山で最寄りのトイレ、薬局、無料Wi-Fi、AED、または観光案内所を探します。韓国政府のオープンデータに基づく8,680件の施設情報で、すべてのレコードは韓国語と英語の両方で提供されます。

これは何ですか？

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

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}	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を指定して、1つの施設の完全なレコードを取得します。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

データの欠落、誤り、または古い情報を報告します。報告はすべて確認され対応されます。以前、英語フィールドが空であるという報告が寄せられ、8,680件すべてのレコードが補完されました。

パラメータ:

• category（必須）: new_data | data_quality | coverage | format | frequency | other

• message（必須）: 問題の内容。施設IDがあれば含めてください。

• priority（任意）: low | medium | high（デフォルト: medium）

クイックスタート

オプションA: Smithery（推奨）

Smithery 上の Busan Essentials にアクセスし、お使いの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

クエリ例

AIエージェントは、これらのツールを使って次のような質問に答えることができます:

英語

• "西面（ソミョン）駅の近くで薬局を探して"

• "海雲台（ヘウンデ）ビーチに最も近い公衆トイレはどこですか？"

• "海雲台（ヘウンデ）で24時間営業の車椅子対応トイレが必要です"

• "広安里（クァンアルリ）エリアで無料Wi-Fiスポットを探して"

• "南浦洞（ナムポドン）に最も近いAEDはどこですか？"

• "私の近くで英語対応の観光案内所はどこですか？"

日本語

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

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

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

中文

• "在西面附近找药店"

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

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

フィードバック

私たちはフィードバックを積極的に検討し、データ品質とカバレッジ向上のために反映しています。

AIエージェント向け: 会話中に submit_feedback ツールを使用して、問題を報告したり改善を提案したりできます。

開発者向け: GitHub でフィードバック issue を開くことができます。

カテゴリ: new_data | data_quality | coverage | format | frequency | other

既知のデータ制限

• subway: 未読込です。Humetro の時刻表API（data.go.kr 15000522）は別途利用申請が必要で、まだ申請中です。そのため get_subway_timetable は全駅で何も返しません。パーサーと設定は準備済みで、キーが承認され次第データが流れます。東海線と釜山-金海軽電鉄は後日対応予定です。

• pharmacy: 24時間営業や外国語対応のフラグはありません。全国規模のE-Genデータソースにそれらが含まれていないため、1,667件すべてのレコードで is_24h が false になります。これはデータソース側の欠落であり、釜山に24時間営業の薬局が存在しないという意味ではありません。

• toilet の座標は区の中心点にフォールバックします。元となる標準データセットからWGS84列が省かれているためです。wifi、pharmacy、aed、tourist_info は正確な座標を持ちます。

• 英語の名前と住所は、改定ローマ字表記法と施設種別の用語集（미래약국 → "Mirae Pharmacy"）によって生成されています。外来語の名前は元の綴りを復元するのではなく音声的にローマ字化されます（오션약국 → "Ocean" ではなく "Osyeon Pharmacy"）。韓国語のフィールドが常に正となります。

• tourist_info は26件ではなく25件です。ソースデータセットにテストエントリ（"테스트 관광안내소"）が含まれており、それを除外しているためです。

データソース

すべてのデータは韓国政府公式オープンデータを元にしており、KOGL Type 1（출처표시 / 表示） の下で利用しています。

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

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

ライセンス

• コード — MIT、LICENSE を参照。

• データ — KOGL Type 1（공공누리 제1유형 · 表示）、NOTICE を参照。商用利用と改変は許可されています。出典元のポータルのクレジット表示が必要です。