Festival Finder

Festival-Finder-mcp

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "junojunhyun-festival-finder-mcp": {
      "command": "python",
      "args": [
        "kakao_server.py"
      ],
      "env": {
        "KOPIS_API_KEY": "YOUR_KOPIS_API_KEY"
      }
    }
  }
}

Festival Finder MCP Server is a modular AI agent that aggregates festival and performance data from the KOPIS API and exposes platform adapters so you can connect it to Kakao Talk or a generic web API. It cleanly separates the core data logic from the platform interfaces, enabling reuse across different channels.

How to use

You access Festival Finder through its platform adapters. Run the adapter servers on your machine, then point your MCP client at the adapter endpoints to fetch festival data. The Kakao adapter is designed for Kakao PlayMCP, and the web adapter provides a general API for web sites or apps. Start the adapters you need, ensure the core logic can reach the KOPIS API, and your client can request performances for given dates. When you connect your client, you will receive structured festival data that you can display or process in your application.

How to install

Prerequisites: install Python 3.8 or newer and have a working Python environment. You may also install dependencies via the project’s requirements file.

pip install -r requirements.txt

# Optional: install via Smithery for automatic MCP setup
npx -y @smithery/cli install @JunoJunHyun/festival-finder-mcp

Additional setup steps

Configure your API key for KOPIS in the core logic file to enable data retrieval from the KOPIS API.

# Open core_logic.py and set your API key in the KOPIS_API_KEY variable
KOPIS_API_KEY = "YOUR_KOPIS_API_KEY"

Available tools

kopis_fetch

Fetches raw festival data from the KOPIS API and returns clean Python data structures to the core engine.

kakao_adapter

Adapter logic that translates Kakao PlayMCP requests into calls to the core engine and formats responses for Kakao.

web_adapter

General-purpose API adapter that exposes core engine data to web clients via HTTP endpoints.