Skip to main content
Glama

Busan Essentials — MCP Server

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

这是什么?

Busan Essentials 是一个 MCP(Model Context Protocol)服务器,为帮助旅行者和居民的 AI 代理回答“釜山最近的 X 在哪里?”这类问题。每条记录都带有韩文和英文名称与地址,因此代理可以把韩文文本交给出租车司机,把英文文本交给旅行者。

Related MCP server: OpenAPI Korea MCP Server

可用数据

类型

描述

数量

aed

AED(除颤器)位置

2,799

toilet

覆盖全部 16 个区的公共卫生间

2,487

wifi

免费公共 WiFi 热点

1,702

pharmacy

釜山的药店

1,667

tourist_info

旅游信息中心

25

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 类(출처표시 / 署名) 使用:

许可

  • 代码 — MIT,请参阅 LICENSE。

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

Related MCP Connectors

Related MCP Servers