playLocal MCP
Enables to generate day trip itineraries in Korea using real-time public data from Korea Tourism Organization, weather, and congestion APIs.
README
playLocal MCP
실시간 공공 데이터를 활용해 한국 지역 여행 코스를 생성하는 PlayMCP용 MCP 서버입니다.
Features
- 한국관광공사 TourAPI 기반 관광지, 음식점, 문화시설 조회
- 기상청 초단기예보 기반 실외/실내 코스 가중치 조정
- 서울 열린데이터 광장 실시간 도시데이터 기반 혼잡도 반영
- 당일치기 코스 자동 생성, 대체 장소, 데이터 출처, 주의사항 반환
Tools
plan_day_trip: 지역, 날짜, 테마, 이동수단을 받아 당일치기 코스 생성search_public_attractions: TourAPI 지역 후보 조회check_weather: 기상청 날씨 조회check_congestion: 서울 실시간 혼잡도 또는 비서울 추정 혼잡도 조회check_open_status: TourAPI 상세 원천 데이터 조회
Environment
.env.example을 .env로 복사한 뒤 값을 채웁니다. 실제 .env는 Git에 올리지 않습니다.
TOUR_API_KEY=
TOUR_API_DECODING_KEY=
WEATHER_API_KEY=
WEATHER_API_DECODING_KEY=
SEOUL_OPEN_API_KEY=
KAKAO_REST_API_KEY=
같은 이름의 키를 두 번 넣으면 일반 dotenv 로딩에서는 뒤쪽 값이 사용됩니다. 가능하면 encoding/decoding 키는 *_ENCODING_KEY, *_DECODING_KEY로 나눠 넣어주세요.
Local Run
pip install -r requirements.txt
python -m local_travel_planner.server
기본 MCP HTTP endpoint는 다음과 같습니다.
http://localhost:8000/mcp
Docker
docker build -t playlocal-mcp .
docker run --env-file .env -p 8000:8000 playlocal-mcp
PlayMCP Deployment
PlayMCP in KC에서는 Git source build 방식을 권장합니다.
- GitHub 저장소에 이 프로젝트를 push합니다.
- PlayMCP in KC에서 My MCP 서버를 생성합니다.
- Git URL, branch, Dockerfile path를 입력합니다.
- 배포 환경변수에
.env와 같은 키 이름을 등록합니다. - 활성화된 Endpoint URL을 PlayMCP 콘솔에 등록합니다.
PlayMCP에 표시할 MCP 이름은 playLocal을 사용합니다. KakaoCloud 리소스 이름이 별도로 필요하면 Kubernetes DNS 규칙에 맞게 playlocal-mcp처럼 소문자, 숫자, 하이픈만 사용하는 것을 권장합니다.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.