MCP Korea Tourism Api

🚀 Korea Tourism Information MCP Service Integration Guide

This guide provides a detailed introduction to integrating the Korea Tourism Information MCP service, including Docker installation steps, integration into Cursor, available MCP tools, and other important considerations.

📦 Installation Guide

📁 Step 1: Create the MCP Directory

Create a new folder named mcp-korea-tourism-api in your project directory. Place all the code and resources related to Korea tourism information in this folder.

mkdir -p mcp-korea-tourism-api
cd mcp-korea-tourism-api

📥 Step 2: Download Dependencies

To ensure the smooth operation of the MCP service, we need to install the necessary Python packages. Create a requirements.txt file and add the following dependencies:

uv>=0.13.0
python-dotenv==0.19.0

⚙️ Step 3: Install Dependencies

Install these packages using pip:

pip install -r requirements.txt

📂 Step 4: Download Korea Tourism Data

To enable the MCP service to access Korea tourism data, you need to obtain the latest XML files from the Korea Tourism Organization. Place these files in the mcp-korea-tourism-api/data directory.

▶️ Step 5: Start the MCP Service

Now you can start the MCP service. Run the following command:

uv run mcp_tourism.server

💻 Integration into Cursor

To use this MCP service in Cursor, follow these steps:

🐳 Step 1: Ensure Docker Container Can Run

Build and run the Docker container according to the above instructions. Make sure the mcp-korea-tourism-api image exists and can run properly.

📄 Step 2: Find Your mcp.json File

This file is used to configure Cursor's MCP tool. Usually, you can find it at ~/.cursor/mcp.json or a similar path.

⚙️ Step 3: Add or Update MCP Configuration

Add the following JSON object to the mcp.json file. If you already have an entry for this tool, update its command property. Replace "YOUR_KTO_API_KEY" with your actual API key.

Configuration Example Using Docker:

{
    "mcpServers": {
        "korea-tourism": {
            "command": "docker",
            "args": [
                "run",
                "--rm",
                "-i",
                "-e",
                "KOREA_TOURISM_API_KEY=YOUR_KTO_API_KEY",
                "mcp-korea-tourism-api"
            ]
        }
    }
}

Configuration Example Using uv:

{
    "mcpServers": {
        "korea-tourism": {
            "command": "uv",
            "args": [
                "--directory",
                "{LOCAL_PATH}/mcp-korea-tourism-api",
                "run",
                "-m",
                "mcp_tourism.server"
            ],
            "env": {
                "KOREA_TOURISM_API_KEY": "YOUR_KTO_API_KEY"
            }
        }
    }
}

💾 Step 4: Save the mcp.json File

After completing the configuration, save the mcp.json file.

🔄 Step 5: Restart Cursor or Reload the MCP Tool

Cursor should be able to detect the new tool and start it using Docker when needed.

✨ Features

This server provides the following functions for AI assistants:

1. search_tourism_by_keyword: Search for tourism information using keywords (e.g., "Gyeongbokgung Palace", "Bibimbap"). Can be filtered by content type and area code.
2. get_tourism_by_area: Browse tourism information based on geographical area codes (e.g., Seoul = '1'). Can be filtered by content type and area code.
3. find_nearby_attractions: Find nearby tourist attractions based on specific GPS coordinates (longitude, latitude). Can be filtered by radius and content type.
4. search_festivals_by_date: Find festival information within a specified date range (format: YYYYMMDD). Can be filtered by area code.
5. find_accommodations: Search for accommodations such as hotels and guesthouses based on the region and area code.
6. get_detailed_information: Get detailed information (overview, operating hours, parking, etc.) of a specific tourism item using the content ID. Can be filtered by content type.
7. get_tourism_images: Get the image URLs of a specific tourism item using the content ID.
8. get_area_codes: Get area codes (cities/provinces) and their optional sub - area codes.

⚠️ Important Note

• Ensure you have a valid API key and understand its usage restrictions and terms.
• Regularly update the Korea Tourism data to ensure the information is up - to - date.
• When using it in a production environment, consider performance optimization and error handling.