Skip to main content
Glama
tour-crowding-mcp

tour-crowding-mcp

by kimbongjune

tour-crowding-mcp

한국관광공사 관광지 혼잡도(집중률) MCP 서버. Claude Desktop 등 MCP 클라이언트에 붙이면 "이번 주말 경주 붐벼?", "전주에서 한적한 데 추천해줘" 같은 질문에 실데이터로 답할 수 있다.

  • LLM 키가 필요 없다. 도구 선택과 답변 작성은 접속한 클라이언트의 모델이 한다.

  • 사용자 본인의 공공데이터포털 키 하나로 동작한다.

  • 저장소가 없다. 프로세스 메모리 캐시로만 돌고, 지역 코드표(첫 실행 18콜)만 ~/.cache/tour-mcp/ 에 파일로 남겨 재시작 시 쿼터를 아낀다.

준비

data.go.kr 에서 아래 두 서비스를 활용신청하고 Decoding 키를 받는다 (Encoding 키를 넣으면 이중 인코딩으로 인증에 실패한다).

  • 한국관광공사 국문 관광정보 서비스 (KorService2)

  • 한국관광공사 관광지 집중률 정보 (TatsCnctrRateService)

두 서비스 모두 심사 없는 자동승인이라 신청 즉시 키가 발급된다. 개인 발급 키의 일일 한도는 보통 1,000회다. usage 도구로 이번 세션의 호출 수를 확인할 수 있다.

Related MCP server: mcp-tour

Claude Desktop 설정

claude_desktop_config.json:

{
  "mcpServers": {
    "tour-crowding": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/kimbongjune/tour-crowding-mcp", "tour-crowding-mcp"],
      "env": { "DATA_GO_KR_SERVICE_KEY": "발급받은 Decoding 키" }
    }
  }
}

로컬 체크아웃으로 쓰려면 --from 에 git 주소 대신 저장소 경로를 넣는다.

도구

도구

하는 일

resolve_area

지역명 → 시군구 코드. 동명 지역이면 후보를 되돌려준다

get_crowding

지역 요약 또는 특정 관광지의 일자별 혼잡도(집중률 예측)

recommend_quiet

앞으로 며칠간 한적할 것으로 예측되는 곳 추천

find_attraction

이름으로 관광지 검색

get_attraction_detail

개요·운영정보 등 상세

list_places

카테고리별 목록 (자연·역사·문화·체험·레저스포츠·쇼핑·음식·숙박·캠핑·웰니스 등)

list_festivals

진행·예정 축제 (기간 포함)

usage

이번 세션에서 사용자 키로 나간 호출 수

혼잡도 수치는 한국관광공사가 산출한 예측값이며 실측이 아니다. 전주시처럼 데이터가 구 단위로 집계되는 지역은 하위 구를 합쳐서 조회한다.

출처: ⓒ한국관광공사

Available Tools

8 tools
find_attractionA

관광지명으로 관광지를 찾는다. 지역을 알면 cd 를 넣어야 동명 관광지가 섞이지 않는다.

Inputs: name (required), cd.

get_attraction_detailB

관광지 상세: 개요, 주소, 운영시간·휴무일 등. 응답에 없는 항목은 명백하게 모른다고 응답하라.

Inputs: content_id (required).

get_crowdingB

지역의 관광지 혼잡도(집중률). names 를 주면 그 관광지들만, 없으면 지역 요약.

수치는 한국관광공사가 산출한 예측값이며 실측이 아니다 — 답할 때 반드시 언급하여라. 등급은 혼잡·보통·한적 세 단어만 사용한다. 지역 요약에는 coverage(전체 몇 곳을 본 결과인지)가 있으니 같이 언급한다. 데이터가 모든 관광지에 있는 것은 아니다.

Inputs: cd (required), days, names.

list_festivalsC

지역에서 진행 중이거나 예정된 축제·행사. date_from(YYYY-MM-DD) 생략 시 오늘.

각 항목의 기간을 같이 안내하고, 물어본 날짜가 기간 안일 때만 '그때 한다'고 말해라.

Inputs: cd (required), limit, date_from.

list_placesB

지역에서 카테고리별로 갈 만한 곳 목록. 카테고리는 한국관광공사 분류체계 기준.

캠핑·야영·글램핑은 category="캠핑", 의료·온천·스파·한방·찜질방·힐링은 category="웰니스" 로 호출한다. 목록 순서는 인기순이 아니다. "한적한 웰니스" 처럼 갈래가 섞인 요청도 이 목록이 답의 중심이다. 갈래 목록에는 혼잡도가 없으니 아는 것처럼 말하지 말고, 목록을 준 뒤 카테고리별 혼잡도는 집계되지 않는다고 응답하여라.

Inputs: cd (required), category (required), limit.

recommend_quietA

지역에서 앞으로 며칠간 한적할 것으로 예측되는 관광지 추천.

같은 지역의 집중률 평균이 낮은 순서다. 순서를 바꾸지 말고 그대로 안내하되, 혼잡도 기준 추천이라는 것과 예측값이라는 것을 언급한다. 카테고리(캠핑·웰니스·음식 등)를 콕 집은 요청에는 이 도구가 아니라 list_places 를 사용한다 — 집중률은 관광지 대상이라 갈래와 결합되지 않는다.

Inputs: cd (required), days, limit.

resolve_areaA

지역명을 시군구 코드로 변환한다.

예: "경주", "전북 전주", "제주시". status 가 ambiguous 면 candidates 를 사용자에게 보여주고 되물어라. 이후 도구들은 여기서 받은 cd 를 사용한다.

Inputs: query (required).

usageA

이번 세션에서 사용자 키로 나간 상류 호출 수. 쿼터가 걱정될 때 확인한다.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 8 tools

    Disambiguation4/5

    Most tools have clearly separate roles—area resolution, attraction lookup, detail, crowding, festivals, and quota usage are easy to tell apart. However, get_crowding and recommend_quiet both deal with crowding-derived information, and find_attraction versus list_places could initially be confused, though the descriptions provide enough guidance.

    Naming Consistency4/5

    The tool names follow a mostly consistent snake_case verb-first pattern such as find_*, get_*, list_*, and resolve_*. Minor deviations include usage, which is a bare noun, and recommend_quiet, which uses an adjective rather than a noun object.

    Tool Count5/5

    Eight tools is well within the ideal range and each tool covers a distinct part of the tourism/crowding workflow: area resolution, attraction search and detail, crowding data, quiet recommendations, category place lists, festivals, and quota checking. Nothing feels redundant or unnecessary.

    Completeness4/5

    The toolset covers the core workflow end-to-end, including resolving areas, finding and inspecting attractions, getting crowding forecasts, listing places and festivals, and monitoring usage. Minor gaps exist—such as no direct combination of category lists with crowding and no explicit date-scoped crowding query—but the descriptions acknowledge these limitations and give agents a workaround.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers