关于 JunoJunHyun-festival-finder-mcp
JunoJunHyun-festival-finder-mcp 通过 KOPIS API 提供韩国演出和节庆信息。其核心数据逻辑与平台适配器分离,可连接 Kakao PlayMCP 或通过通用 Web API 使用。
主要功能
- 01获取演出和节庆信息
- 02使用 KOPIS API 数据
- 03将核心逻辑与适配器分离
- 04通过 Kakao PlayMCP 适配器连接
- 05提供通用 Web API 适配器
适用场景
- 01查找韩国演出和节庆信息
- 02将节庆数据连接到 Kakao PlayMCP
- 03通过 Web API 请求演出数据
MCP 相关
项目包含 Kakao PlayMCP 适配器服务,用于将核心数据逻辑连接到该平台;还提供通用 Web API 适配器。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://server.smithery.ai/@JunoJunHyun/festival-finder-mcp/mcpclaude mcp add --transport http ai-smithery-junojunhyun-festival-finder https://server.smithery.ai/@JunoJunHyun/festival-finder-mcp/mcp{"mcpServers":{"ai-smithery-junojunhyun-festival-finder":{"type":"http","url":"https://server.smithery.ai/@JunoJunHyun/festival-finder-mcp/mcp"}}}在 Cursor 中打开{"servers":{"ai-smithery-junojunhyun-festival-finder":{"type":"http","url":"https://server.smithery.ai/@JunoJunHyun/festival-finder-mcp/mcp"}}}在 VS Code 中打开{"mcpServers":{"ai-smithery-junojunhyun-festival-finder":{"type":"http","url":"https://server.smithery.ai/@JunoJunHyun/festival-finder-mcp/mcp"}}}{"mcpServers":{"ai-smithery-junojunhyun-festival-finder":{"serverUrl":"https://server.smithery.ai/@JunoJunHyun/festival-finder-mcp/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://server.smithery.ai/@JunoJunHyun/festival-finder-mcp/mcp需要授权工具
详细介绍
Festival-Finder-mcp
Festival Finder(페스티벌 파인더)
通用 AI Agent“페스티벌 파인더”。该项目将核心逻辑与平台适配器分离,旨在连接 KakaoTalk、普通网站等各种平台。它使用 KOPIS(演出艺术综合电算网)API,提供全国各地的演出和节庆信息。
🏗️ 架构
本项目采用可扩展的架构,由“核心引擎(Core Engine)”和“连接适配器(Connection Adapters)”两大部分组成。
🧠 核心引擎:core_logic.py
- 与平台无关的纯业务逻辑。
- 负责从 KOPIS API 获取数据,并以未经加工的纯 Python 数据形式返回。
- 完全不了解连接的是哪个平台,因此可以在任何地方重复使用。
📞 连接适配器
-
作为将核心引擎连接到各种外部平台的“插件”。
-
处理各平台独有的请求/响应格式,并与核心引擎通信。
-
kakao_server.py:适用于 Kakao PlayMCP 的适配器服务。 -
web_server.py:适用于 普通网站或应用 的通用 API 适配器服务。
🛠️ 开始使用
- 安装所需库
pip install -r requirements.txt
通过 Smithery 安装
通过 Smithery 自动安装 festival-finder-mcp:
npx -y @smithery/cli install @JunoJunHyun/festival-finder-mcp
-
设置 KOPIS API 密钥 打开
core_logic.py文件,在KOPIS_API_KEY变量中输入你获取的 API 密钥。 -
运行适配器服务 在终端中运行所需的适配器服务。
-
测试 KakaoTalk 集成时:
python kakao_server.py- 将 ngrok 连接到
http://localhost:5000,并在 PlayMCP Endpoint 中注册[ngrok 地址]/kakao。
- 将 ngrok 连接到
-
测试通用 Web API 时:
python web_server.py- 可以在 Web 浏览器或其他程序中通过
http://localhost:5001/api/performances?stdate=...格式发送请求进行测试。
- 可以在 Web 浏览器或其他程序中通过
-
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。