Korea Tourism API MCP Server ✈️

Unlock the wonders of South Korean tourism directly within your AI assistant! This project provides a Model Context Protocol (MCP) server powered by the official Korea Tourism Organization (KTO) API. Equip your AI with the ability to discover vibrant festivals, serene temples, delicious restaurants, comfortable accommodations, and much more across Korea.

Links:

• PyPI Package: https://pypi.org/project/mcp-korea-tourism-api/
• GitHub Repository: https://github.com/harimkang/mcp-korea-tourism-api
• Releases: https://github.com/harimkang/mcp-korea-tourism-api/releases

✨ Features

• Comprehensive Search: Find tourist spots, cultural sites, events, food, lodging, and shopping via keywords, area, or location.
• Rich Details: Access descriptions, operating hours, admission fees, photos, addresses, and contact information.
• Location-Aware: Discover attractions near specific GPS coordinates.
• Timely Information: Find festivals and events based on date ranges.
• Multilingual Support: Get information in various languages supported by the KTO API (including English).
  • Supported Languages: English, Japanese, Simplified Chinese, Traditional Chinese, Russian, Spanese, German, French
• Efficient & Resilient:
  • Response Caching: Uses time-to-live (TTL) caching to store results and reduce redundant API calls, improving speed.
  • Rate Limiting: Respects API usage limits to prevent errors.
  • Automatic Retries: Automatically retries requests in case of temporary network or server issues.
• MCP Standard: Seamlessly integrates with AI assistants supporting the Model Context Protocol.

⚠️ Prerequisites

Before you begin, you must obtain an API key from the Korea Tourism Organization (KTO) Data Portal.

1. Visit the KTO Data Portal (or the specific portal for the tourism API if available).
2. Register and request an API key for the "TourAPI" services (you might need to look for services providing information like areaBasedList, searchKeyword, detailCommon, etc.).
3. Keep your Service Key (API Key) safe. It will be required during installation or runtime.

You need to apply for the API below to make a request for each language.

• English: https://www.data.go.kr/data/15101753/openapi.do
• Japanese: https://www.data.go.kr/data/15101760/openapi.do
• Simplified Chinese: https://www.data.go.kr/data/15101764/openapi.do
• Traditional Chinese: https://www.data.go.kr/data/15101769/openapi.do
• Russian: https://www.data.go.kr/data/15101831/openapi.do
• Spanese: https://www.data.go.kr/data/15101811/openapi.do
• German: https://www.data.go.kr/data/15101805/openapi.do
• French: https://www.data.go.kr/data/15101808/openapi.do

🚀 Installation & Running

You can run this MCP server using either uv (a fast Python package installer and runner) or Docker.

Installing via Smithery

To install Korea Tourism API MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery

... [View full README on GitHub](https://github.com/harimkang/mcp-korea-tourism-api#readme)