AI导哈

节日活动查询服务

一个通用的AI代理，通过KOPIS API提供全国各地的演出和节日信息，支持多种平台连接。

  • by JunoJunHyun
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 JunoJunHyun/Festival-Finder-mcp

使用说明

节日查找器-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适配器服务器。

🛠️ 开始

  1. 安装所需库
    pip install -r requirements.txt

通过Smithery进行安装

通过自动安装 festival-finder-mcp “Smithery”可以翻译为“铁匠铺”或“锻造工坊”:

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

  1. KOPIS API密钥设置 core_logic.py 打开文件 KOPIS_API_KEY 请输入变量中颁发的您的API密钥。

  2. 运行适配器服务器 在终端中运行所需的适配器服务器。

    • 在进行KakaoTalk联动测试时：

      python kakao_server.py
      • ngrok http://localhost:5000连接到，并在PlayMCP终端上 [ngrok 주소]/kakao进行注册。

    • 在进行一般Web API测试时：

      python web_server.py
      • 在网页浏览器或其他程序中 http://localhost:5001/api/performances?stdate=... 可以以某种形式请求进行测试。

相关 MCP