tour-crowding-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tour-crowding-mcp 이번 주말 부산 해운대 혼잡도 알려줘"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 주소 대신 저장소 경로를 넣는다.
도구
도구 | 하는 일 |
| 지역명 → 시군구 코드. 동명 지역이면 후보를 되돌려준다 |
| 지역 요약 또는 특정 관광지의 일자별 혼잡도(집중률 예측) |
| 앞으로 며칠간 한적할 것으로 예측되는 곳 추천 |
| 이름으로 관광지 검색 |
| 개요·운영정보 등 상세 |
| 카테고리별 목록 (자연·역사·문화·체험·레저스포츠·쇼핑·음식·숙박·캠핑·웰니스 등) |
| 진행·예정 축제 (기간 포함) |
| 이번 세션에서 사용자 키로 나간 호출 수 |
혼잡도 수치는 한국관광공사가 산출한 예측값이며 실측이 아니다. 전주시처럼 데이터가 구 단위로 집계되는 지역은 하위 구를 합쳐서 조회한다.
출처: ⓒ한국관광공사
Available Tools
8 toolsfind_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
Scored across 8 tools
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.
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.
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.
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
Related MCP Connectors
Real-world measured visit big data and travel course recommendation MCP for South Korea.
Korea travel data: 50K+ places in 13 languages, festivals, crowd forecasts, itineraries
Seoul Open Data MCP — city data for Seoul via the Seoul Open Data Plaza API (openapi.seoul.go.kr).…
Korea travel & K-pop live data for agents: concerts, Seoul trip packs, crowd, subway, airport.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to access South Korean tourism information via the official Korea Tourism Organization API, providing comprehensive search for attractions, events, food, and accommodations with multilingual support.832 PyPI9MIT
- FlicenseNot gradedqualityDmaintenanceIntegrates the Korea Tourism Organization's API to provide tourist spot recommendations and detailed information, including attractions, food, and accommodation.1-
- FlicenseNot gradedqualityDmaintenanceEnables to generate day trip itineraries in Korea using real-time public data from Korea Tourism Organization, weather, and congestion APIs.-
- AlicenseNot gradedqualityDmaintenanceEnables querying South Korean meteorological observation data and short-term forecasts by region name or grid coordinates via the MCP protocol.MIT