JunoJunHyun Festival Finder Mcp

ai.smitheryPublished by smithery.aiOfficial publisherv1.16.0Updated Oct 24, 2026

Discover festivals worldwide by location, date, and genre. Compare options with key details like d…

The publisher's own server: 222wcnm Bilistalkermcp

VerifiedStreamable HTTPWeb executableLocation & LifestyleWeb Search & Scraping

Overview

AI-generated overview

Lets an assistant look up performances and festivals across regions by location, date, and genre using Korean KOPIS data.

What you can do
This server exposes a festival and performance finder backed by the KOPIS (Korean performing arts information system) API. It retrieves performance and festival listings and returns them as structured data, so an assistant can search by region, date range, and genre and compare options with key details. The project separates a platform-independent core engine from connection adapters, including one for Kakao PlayMCP and a general web API adapter.
When to use it
Useful when someone wants an assistant to find or compare performances and festivals, especially in Korea, by location, date, or genre. It fits trip or outing planning and event discovery conversations where up-to-date listing data matters.
Requirements
Runs as a remote streamable HTTP endpoint; the manifest declares no environment variables and no authentication, though an Authorization bearer header is listed for Smithery. The underlying project requires a KOPIS API key set in the core logic and a Python environment with its requirements installed if self-hosted.
Before you install
The README instructs placing a personal KOPIS API key directly in a source file, which risks exposing the credential if the code is shared. The Smithery Authorization bearer token is a credential and should be kept private. Listing data comes from a third-party Korean public API, so accuracy and coverage depend on that source.

Installation

In SourceWeft

  1. Open JunoJunHyun Festival Finder Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/ai.smithery%2FJunoJunHyun-festival-finder-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "junojunhyun-festival-finder": {
      "type": "http",
      "url": "https://server.smithery.ai/@JunoJunHyun/festival-finder-mcp/mcp"
    }
  }
}

README

Festival-Finder-mcp

[smithery badge]

Festival Finder (페스티벌 파인더)

범용 AI 에이전트 '페스티벌 파인더'입니다. 핵심 로직과 플랫폼별 어댑터를 분리하여 카카오톡, 일반 웹사이트 등 다양한 플랫폼에 연결할 수 있도록 설계되었습니다. KOPIS(공연예술통합전산망) API를 사용하여 전국의 공연 및 축제 정보를 제공합니다.

🏗️ 아키텍처

이 프로젝트는 **'핵심 엔진(Core Engine)'**과 **'연결 어댑터(Connection Adapters)'**라는 두 가지 주요 부분으로 구성된 확장 가능한 구조를 따릅니다.

🧠 핵심 엔진: core_logic.py

  • 플랫폼에 독립적인 순수 비즈니스 로직입니다.
  • KOPIS API에서 데이터를 가져오고, 가공되지 않은 순수한 파이썬 데이터 형태로 반환하는 역할만 담당합니다.
  • 어떤 플랫폼에 연결되는지 전혀 알지 못하며, 어디서든 재사용이 가능합니다.

📞 연결 어댑터

  • 핵심 엔진을 다양한 외부 플랫폼에 연결하는 '플러그' 역할을 합니다.

  • 각 플랫폼의 고유한 요청/응답 형식을 처리하고, 핵심 엔진과 통신합니다.

  • kakao_server.py: 카카오 PlayMCP용 어댑터 서버입니다.

  • web_server.py: 일반 웹사이트나 앱을 위한 범용 API 어댑터 서버입니다.

🛠️ 시작하기

  1. 필요 라이브러리 설치
    bash
    pip install -r requirements.txt

Installing via Smithery

To install festival-finder-mcp automatically via Smithery:

bash
npx -y @smithery/cli install @JunoJunHyun/festival-finder-mcp

  1. KOPIS API 키 설정 core_logic.py 파일을 열어 KOPIS_API_KEY 변수에 발급받은 본인의 API 키를 입력하세요.

  2. 어댑터 서버 실행 필요한 어댑터 서버를 터미널에서 실행합니다.

    • 카카오톡 연동 테스트 시:

      bash
      python kakao_server.py
      • ngrok을 http://localhost:5000에 연결하고, PlayMCP Endpoint에 [ngrok 주소]/kakao를 등록합니다.

    • 일반 웹 API 테스트 시:

      bash
      python web_server.py
      • 웹 브라우저나 다른 프로그램에서 http://localhost:5001/api/performances?stdate=... 형식으로 요청하여 테스트할 수 있습니다.

Source: README.md at commit eeb0870

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.16.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Smithery integrations

222wcnm Bilistalkermcp

ai.smitheryOfficial publisher

Bilibili creator analysis server that lets an assistant look up a specific user's profile, videos, dynamics, articles, subtitles, followings and comments.

Streamable HTTPWeb executable
Knowledge & MemoryNot indexed yetOct 24, 2026

Zwldarren Akshare One Mcp

ai.smitheryOfficial publisher

Remote MCP server that gives an assistant read-only access to Chinese stock market data: historical and real-time prices, news, and financial statements.

Streamable HTTPWeb executableAuth
FinanceCredential requiredOct 24, 2026

Zhaoganghao Hellomcp

ai.smitheryOfficial publisher

A small remote MCP server that lets an assistant greet people by name and share background on the origin of 'Hello, World'.

Streamable HTTPWeb executable
Not indexed yetOct 24, 2026

Zeta Chain Cli

ai.smitheryOfficial publisher

A remote MCP server that lets an assistant generate friendly, customizable greetings for any name or audience.

Streamable HTTPWeb executableAuth
Credential requiredOct 24, 2026

Yuna0x0 Hackmd Mcp

ai.smitheryOfficial publisher

An MCP server that connects an assistant to the HackMD API so it can read, create, update and delete HackMD notes and manage teams.

Streamable HTTPWeb executable
Communication & CollaborationNot indexed yetOct 25, 2026