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 集成