Busan Essentials — MCP 서버

부산에서 가장 가까운 화장실, 약국, 무료 와이파이, 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로 전체 레코드를 가져옵니다. 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 (선택): 하나의 시설 유형으로 제한합니다. 생략하면 가장 가까운 모든 것을 가져옵니다.

• 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시간 운영하는 화장실이 필요해"

• "광안리 지역에서 무료 와이파이 핫스팟 찾아줘"

• "남포동에서 가장 가까운 AED는 어디야?"

• "내 근처에 영어를 할 줄 아는 직원이 있는 관광안내소는 어디야?"

日本語

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

• 「広安里（クァンアルリ）の近くで無料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 소스에는 해당 정보가 없으므로 is_24h는 1,667개 레코드 모두에서 false로 표시됩니다. 이는 부산에 24시간 약국이 없다는 의미가 아니라 소스 데이터의 한계입니다.

• toilet 좌표는 구의 중심점으로 대체됩니다. 상위 표준 데이터셋에 WGS84 열이 빠져 있습니다. wifi, pharmacy, aed, tourist_info는 정확한 좌표를 가지고 있습니다.

• 영문 이름과 주소는 수정 로마자 표기법과 시설 유형 용어집(미래약국 → "Mirae Pharmacy")으로 생성됩니다. 외래어 이름은 원래 철자를 복원하지 않고 음역됩니다(오션약국 → "Osyeon Pharmacy", "Ocean" 아님). 한국어 필드는 항상 공식 정보입니다.

• **tourist_info**는 26개가 아닌 25개 레코드입니다. 원본 데이터셋에 테스트 항목("테스트 관광안내소")이 포함되어 있어 제외되었습니다.

데이터 출처

모든 데이터는 대한민국 정부 공공데이터에서 가져왔으며, KOGL Type 1 (출처표시 / Attribution) 조건으로 사용됩니다:

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

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

라이선스

• 코드 — MIT, LICENSE 참조.

• 데이터 — KOGL Type 1 (공공누리 제1유형 · Attribution), NOTICE 참조. 상업적 사용 및 수정이 허용되며, 출처 포털을 명시해야 합니다.