Busan Essentials — MCP Server

查找韩国釜山最近的卫生间、药店、免费 WiFi、AED 或旅游信息中心。来自韩国政府开放数据的 8,680 个地点，每条记录均有韩文和英文。

这是什么？

Busan Essentials 是一个 MCP（Model Context Protocol）服务器，为帮助旅行者和居民的 AI 代理回答“釜山最近的 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}	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（必需）：地点 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 代理可以使用这些工具来回答如下问题：

英语

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

反馈

我们积极审查并采纳反馈，以提升数据质量和覆盖面。

对于 AI 代理： 在对话过程中使用 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 第 1 类（출처표시 / 署名） 使用：

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

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

许可

• 代码 — MIT，请参阅 LICENSE。

• 数据 — KOGL 第 1 类（공공누리 제1유형 · 署名），请参阅 NOTICE。允许商业使用和修改；必须注明来源门户。