busan-essentials

釜山生活必备 — MCP 服务

在韩国釜山查找最近的洗手间、药房、免费 WiFi、AED 或旅游信息中心。数据来自韩国政府开放数据，共有 8,680 个地点，每条记录都包含韩语和英语信息。

这是什么？

Busan Essentials 是一个 MCP（Model Context Protocol）服务，可为帮助旅行者和居民的 AI Agent 解答“釜山哪里有最近的 X？”等问题。每条记录都附有韩语和英语名称及地址，因此 Agent 可以把韩语文本交给出租车司机，把英语文本提供给旅行者。

可用数据

类型	描述	数量
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 不包含可用筛选条件 — 上游数据源未记录各设施之间的差异。使用未知筛选键时会返回零条结果，而不是忽略该筛选条件。

• 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（推荐）

访问 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 Agent 可以使用这些工具回答以下问题：

英语

• “帮我找西面站附近的药店”
• “海云台海滩最近的公共卫生间在哪里？”
• “我需要海云台一间 24 小时开放的无障碍卫生间”
• “帮我找广安里附近的免费 WiFi 热点”
• “南浦洞最近的 AED 在哪里？”
• “我附近哪家旅游咨询中心有会说英语的工作人员？”

日语

• 「帮我找西面（ソミョン）的药店」
• 「广安里（クァンアルリ）附近哪里可以使用免费 Wi-Fi？」
• 「告诉我海云台（ヘウンデ）站周边的公共卫生间」

中文

• “在西面附近找药店”
• “广安里附近哪里有免费 WiFi？”
• “南浦洞附近最近的 AED 在哪里？”

反馈

我们会积极审核并采纳反馈，以提升数据质量和覆盖范围。

面向 AI Agent： 在对话期间使用 submit_feedback 工具报告问题或提出改进建议。

面向开发者： 在 GitHub 上提交反馈问题。

类别： 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”）。外来词名称会按发音转写，而非还原原始拼写（오션약국 → “Osyeon Pharmacy”，而非 “Ocean”）。韩文信息始终是权威信息。
• **tourist_info**共有 25 条记录，而非 26 条：源数据集包含一条测试记录（“테스트 관광안내소”），该记录已排除。

数据来源

所有数据均来自韩国政府官方开放数据，并依据 **KOGL Type 1（출처표시 / Attribution）**使用：

• 韩国开放数据门户（data.go.kr）
• 釜山开放数据门户（data.busan.go.kr）

许可证

• 代码 — MIT，详见 LICENSE。
• 数据 — KOGL Type 1（공공누리 제1유형 · Attribution），详见 NOTICE。允许商业使用和修改，但必须注明原始门户。