Busan Essentials
概览
作者提供的说明(英文原文)
Find the nearest restroom, pharmacy, WiFi, or AED in Busan, Korea. 8,680 places, Korean+English.
PopNx MCP 的三大支柱
这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。
- 用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
- 我们的基础检查i2 项中通过 2 项依据公开信息检查;尚未扫描代码
- 使用情况i非常新★ 0
它能帮你做什么
我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。
- 连接方式: 在你的电脑上运行
- 传输方式: Streamable HTTP
- 分类: 诊所与健康
安装
选择你使用的 AI 应用,然后复制设置。
安装之前
- 基础检查:2 项中通过 2 项
- 在你的电脑上运行,拥有你的用户账户的权限(文件、网络、应用)。
- 注册中心没有列出需要填写的密钥。
你需要
- Docker已安装 Docker
你用的是哪个应用?
在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。
打开 Claude Desktop → Settings → Developer → Edit Config,把下面的内容粘贴到 claude_desktop_config.json
{
"mcpServers": {
"busan-essentials": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/do-droid/busan-essentials:0.1.1"
]
}
}
}在终端中运行这条命令
claude mcp add busan-essentials -- docker run -i --rm ghcr.io/do-droid/busan-essentials:0.1.1或者自己复制设置
粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json
{
"mcpServers": {
"busan-essentials": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/do-droid/busan-essentials:0.1.1"
]
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
或者自己复制设置
粘贴到项目中的 .vscode/mcp.json
{
"servers": {
"busan-essentials": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/do-droid/busan-essentials:0.1.1"
]
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
这个服务器在你的电脑上运行,而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。
你的选择通过 Cookie 保存在这台设备上,无需账户。
这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
它能做什么
它在你的电脑上运行;安装后,工具列表会显示在你的 AI 应用中。
基础检查i
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月10日
- ✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 do-droid 验证,该账户拥有此仓库
- ✓ 通过
仍在维护
代码最后更新于3个月前
- … 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
- – 不适用
端点有响应
它在你的电脑上运行,没有互联网端点
- – 不适用
使用 OAuth 登录
在你的电脑上运行,改用本地设置
- … 尚未检查
工具描述中没有隐藏指令
它在你的电脑上运行;我们只能读取互联网端点的工具列表
与“诊所与健康”中的其他服务器比较i
- 星标数多于此分类中其他 1062 个服务器的 0%
- 发布到注册中心的时间比此分类中其他 1062 个服务器的 25% 更新
- 基础检查结果等于或优于此分类中其他 1062 个服务器的 100%
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
常见问题
Busan Essentials 安全吗?
它在 2 项适用的基础检查中通过了 2 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
它需要哪些密钥或代码?
注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。
它在我的电脑上运行还是在云端?
它在你的电脑上运行。你的 AI 应用会在需要时启动它,数据不会经过作者的服务器(除非它自己调用在线服务)。
它还在维护吗?
GitHub 仓库最后更新于3个月前,最新版本(0.1.1)于3个月前进入注册中心。
哪些应用可以使用它?
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Docker。
有什么可以替代它?
同一分类中有:Medplum MCP, Mirobody, Apple Health
替代选择
同一分类中其他作者的服务器,按星标数排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
Mirobody
Lab results to LOINC codes and UCUM units, symptoms and diagnoses to ICPC-3. Offline, no API key.
Apple Health
Local-first Apple Health MCP server for questions about your sleep, workouts and heart data.
作者的 README
打开 README
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
Busan Essentials — MCP Server
Find the nearest restroom, pharmacy, free WiFi, AED, or tourist information center in Busan, South Korea. 8,680 places from Korean government open data, every record in both Korean and English.
What is this?
Busan Essentials is an MCP (Model Context Protocol) server that answers "where is the nearest X in Busan?" for AI agents helping travellers and residents. Every record carries a Korean and English name and address, so an agent can hand the Korean text to a taxi driver and the English to the traveller.
Available Data
| Type | Description | Count |
|---|---|---|
aed | AED (defibrillator) locations | 2,799 |
toilet | Public restrooms across all 16 districts | 2,487 |
wifi | Free public WiFi hotspots | 1,702 |
pharmacy | Pharmacies in Busan | 1,667 |
tourist_info | Tourist information centers | 25 |
8,680 places live across all 16 Busan districts, sourced from data.go.kr. Each record has GPS coordinates, opening hours, accessibility flags, and a
trust_score.
Not covered: subway and bus timetables, taxis, restaurants, hotels, attractions, and anywhere outside Busan.
get_subway_timetableis registered but has no data loaded — see Known Data Limitations.
MCP Tools
find_places
Search by type, district, and attributes. Use find_nearby instead when the user has a location or asks for the *nearest* one.
Parameters:
type(required):"toilet"|"pharmacy"|"wifi"|"aed"|"tourist_info"district(optional): Busan district name in English or Korean (e.g.,"haeundae","해운대구")filters(optional): Attribute filters, all of which must match. Only these exist:
| Type | Filter | Matching records |
|---|---|---|
toilet | {"wheelchair": true} | 1,050 of 2,487 |
toilet | {"is_24h": true} | 839 of 2,487 |
toilet | {"diaper_table": true} | 433 of 2,487 |
tourist_info | {"english": true} | 14 of 25 |
tourist_info | {"chinese": true} | 13 of 25 |
tourist_info | {"japanese": true} | 9 of 25 |
pharmacy, wifi, and aed carry no usable filter — the upstream sources record no per-facility variation. An unknown filter key returns zero results rather than being ignored.
limit(optional): Max results, 1-50 (default: 10)
get_place_detail
Get the full record for one facility by its ID. IDs come from find_places or find_nearby — don't guess them.
Parameters:
id(required): Place ID (e.g.,"toilet_00001","pharmacy_0538","aed_00001","tourist_info_08")
find_nearby
Find the nearest facilities to a GPS point, sorted by distance. The right default for "nearest", "closest", or "around here" — and for urgent needs.
Parameters:
lat(required): Latitude (Busan spans ~35.04 to ~35.40)lng(required): Longitude (Busan spans ~128.78 to ~129.30)radius_m(optional): Search radius in meters, 100-5000 (default: 500). Widen it if the first call comes back empty — 500m is dense downtown but sparse in outer districts.type(optional): Restrict to one facility type. Omit to get whatever is closest.limit(optional): Max results, 1-20 (default: 5)
Each result includes distance_m, the straight-line distance from the search point.
get_subway_timetable
Not available yet. No timetable data is loaded, so every call returns nothing for every station. The tool stays registered so it starts working the moment the data lands — see Known Data Limitations.
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|othermessage(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_timetablereturns 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_24hreadsfalseon 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, andtourist_infohave 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):