JunoJunHyun Festival Finder Mcp

ai.smithery由 smithery.ai 發布官方發布者v1.16.0更新於 Oct 24, 2026

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

發布方自己的服務:222wcnm Bilistalkermcp

已驗證Streamable HTTP可網頁執行位置與生活網頁搜尋與抓取

概覽

AI 產生的概覽

讓助理依地區、日期與類型查詢韓國 KOPIS 資料中的演出與慶典資訊。

可以做什麼
此伺服器提供以 KOPIS(韓國表演藝術整合資訊系統)API 為基礎的演出與慶典查詢功能。它取得演出與慶典清單並以結構化資料回傳,讓助理能依地區、日期範圍與類型檢索,並比較關鍵細節。專案將平台無關的核心引擎與連線轉接器分離,包含面向 Kakao PlayMCP 的轉接器與通用 Web API 轉接器。
適用情境
適合需要助理依地點、日期或類型尋找或比較演出與慶典的情境,尤其是在韓國。適用於行程或出遊規劃以及活動探索類對話,需要較新清單資料時。
執行需求
以遠端 streamable HTTP 端點執行;資訊清單宣告無環境變數、無驗證,但列出了用於 Smithery 的 Authorization bearer 標頭。若自行部署,底層專案需要在核心邏輯中設定 KOPIS API 金鑰,並安裝相依的 Python 環境。
安裝前請注意
README 要求把個人 KOPIS API 金鑰直接寫入原始碼檔案,程式碼共享時可能外洩該憑證。Smithery 的 Authorization bearer 權杖屬於憑證,應妥善保密。清單資料來自第三方韓國公共 API,準確性與涵蓋範圍取決於該來源。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 JunoJunHyun Festival Finder Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/ai.smithery%2FJunoJunHyun-festival-finder-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "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=... 형식으로 요청하여 테스트할 수 있습니다.

來源:README.md,提交 eeb0870

工具

0
SourceWeft 尚未讀取此伺服器的工具。

版本歷史

1
  1. v1.16.0最新Sep 16, 2026

評分

已滿足適用檢查項的 75%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。

其他 Smithery 整合