节日查找器-mcp
](https://smithery.ai/server/@JunoJunHyun/festival-finder-mcp)
Festival Finder（节日查找器）
这是通用AI代理“Festival Finder”。它通过分离核心逻辑和平台适配器，被设计成能够连接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进行安装
通过自动安装 festival-finder-mcp “Smithery”可以翻译为“铁匠铺”或“锻造工坊”:
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终端上 [ngrok 주소]/kakao进行注册。
- 在进行一般Web API测试时：
python web_server.py- 在网页浏览器或其他程序中 http://localhost:5001/api/performances?stdate=... 可以以某种形式请求进行测试。