Seoul Cultural Events MCP Server
A Model Context Protocol (MCP) server that provides access to Seoul's cultural events data through the Seoul Open Data API.
Overview
This MCP server enables AI assistants like Claude to search and retrieve real-time information about cultural events in Seoul, including:
- 🎭 Performances (concerts, theater, musicals)
- 🎨 Exhibitions and art events
- 🎪 Cultural festivals
- 📍 Event locations and venues
- 💰 Ticket prices and booking information
- 📅 Event schedules and dates
Data Source: Seoul Open Data Portal - 서울시 문화행사 정보 (culturalEventInfo) Update Frequency: Daily
Features
- ✅ 23 Data Fields: Comprehensive event information including title, venue, dates, fees, performers, and more
- ✅ Flexible Filtering: Search by category, title, or date
- ✅ Pagination Support: Handle large result sets efficiently (up to 1000 records per request)
- ✅ Error Handling: Graceful handling of API errors and validation
- ✅ Type Safety: Full Pydantic models for data validation
- ✅ Async Support: Built with async/await for optimal performance
Installation
Prerequisites
- Python 3.10 or higher
- uv package manager
- Seoul Open Data API key (free registration)
Quick Start
bash