mcpField
J
JunoJunHyun-festival-finder-mcp

JunoJunHyun-festival-finder-mcp

远程服务
github.com/JunoJunHyun游戏娱乐055 周前更新
代码仓库

关于 JunoJunHyun-festival-finder-mcp

JunoJunHyun-festival-finder-mcp 通过 KOPIS API 提供韩国演出和节庆信息。其核心数据逻辑与平台适配器分离,可连接 Kakao PlayMCP 或通过通用 Web API 使用。

主要功能

  1. 01获取演出和节庆信息
  2. 02使用 KOPIS API 数据
  3. 03将核心逻辑与适配器分离
  4. 04通过 Kakao PlayMCP 适配器连接
  5. 05提供通用 Web API 适配器

适用场景

  1. 01查找韩国演出和节庆信息
  2. 02将节庆数据连接到 Kakao PlayMCP
  3. 03通过 Web API 请求演出数据

MCP 相关

项目包含 Kakao PlayMCP 适配器服务,用于将核心数据逻辑连接到该平台;还提供通用 Web API 适配器。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://server.smithery.ai/@JunoJunHyun/festival-finder-mcp/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址
Streamable HTTPhttps://server.smithery.ai/@JunoJunHyun/festival-finder-mcp/mcp需要授权

工具

详细介绍

Festival-Finder-mcp

smithery badge

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 适配器服务。


🛠️ 开始使用

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

通过 Smithery 自动安装 festival-finder-mcp:

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 Endpoint 中注册 [ngrok 地址]/kakao。
    • 测试通用 Web API 时:

      python web_server.py
      
      • 可以在 Web 浏览器或其他程序中通过 http://localhost:5001/api/performances?stdate=... 格式发送请求进行测试。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。