mcp-tour 0.1.8

MCP server providing Korea Tourism Organization APIs

py-mcp-tour

Korea Tourism Organization API integration for Claude using MCP protocol.

Description

This MCP server provides access to Korea Tourism Organization's tourism data API, specifically focusing on related tourist spots information.

Features

• Get related tourist spots information
• Get detailed spot information
• Support for different content types (tourist spots, food, accommodation)
• National Standard Tourism Data API support

Setup

1. Get an API key from Data.go.kr
2. Set environment variable in .env file:

   TOUR_API_KEY=your-api-key
   

Installation

Regular Installation

pip install mcp-tour

Claude Desktop Installation

Using uv (recommended):

uv pip install mcp-tour

uv run python -m mcp_tour.hosts.claude_desktop \
  -e TOUR_API_KEY=your-api-key

Using pip:

pip install mcp-tour

python -m mcp_tour.hosts.claude_desktop \
  -e TOUR_API_KEY=your-api-key

Usage

The server provides the following tools:

get_area_based_list

Get area-based tourist spots information:

Parameters:

• area_code: Area code for the region
• signgu_code: Signgu (city/district) code
• content_type_id (optional): Content type ID (12: Tourist Spots, 39: Restaurants, 32: Accommodation)
• size: Number of results (max 50)

search_by_keyword

Search tourist spots by keyword:

Parameters:

• keyword: Search keyword
• area_code: Area code for the region
• signgu_code: Signgu (city/district) code
• content_type_id (optional): Content type ID (12: Tourist Spots, 39: Restaurants, 32: Accommodation)
• size: Number of results (max 50)

get_standard_tour_list

Get tourist spots information from the National Standard Tourism Data API:

Parameters:

• page_no (optional): Page number (default: 1)
• num_of_rows (optional): Number of rows per page (default: 100)
• tourist_spot_name (optional): Name of the tourist spot to search for
• address (optional): Address to search for

Development

1. Clone the repository
2. Install dependencies:

   uv pip install -e ".[dev]"
   

   or using pip:

   pip install -e ".[dev]"
   

3. Run tests:

   python -m pytest
   

License

This project is licensed under the terms of the MIT license.