JunoJunHyun-festival-finder-mcp

Festival-Finder-mcp

Festival Finder（フェスティバルファインダー）

汎用 AI エージェント「フェスティバルファインダー」です。中核ロジックとプラットフォーム別アダプターを分離し、カカオトーク、一般的なウェブサイトなど、さまざまなプラットフォームに接続できるように設計されています。KOPIS（公演芸術統合電算網）API を使用して、全国の公演やフェスティバルの情報を提供します。

---

🏗️ アーキテクチャ

このプロジェクトは、**「コアエンジン（Core Engine）」と「接続アダプター（Connection Adapters）」**という 2 つの主要な部分で構成される、拡張可能な構造を採用しています。

🧠 コアエンジン：core_logic.py

• プラットフォームに依存しない、純粋なビジネスロジックです。
• KOPIS API からデータを取得し、加工されていない純粋な Python のデータ形式で返す役割のみを担います。
• 接続先のプラットフォームを一切認識せず、どこでも再利用できます。

📞 接続アダプター

• コアエンジンをさまざまな外部プラットフォームに接続する「プラグ」の役割を果たします。

• 各プラットフォーム固有のリクエスト／レスポンス形式を処理し、コアエンジンと通信します。

• kakao_server.py：カカオ 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

2. KOPIS API キーの設定 core_logic.py ファイルを開き、KOPIS_API_KEY 変数に取得したご自身の API キーを入力してください。

3. アダプターサーバーの実行 必要なアダプターサーバーをターミナルで実行します。

   • カカオトーク連携をテストする場合：

     python kakao_server.py
     

     • ngrok を http://localhost:5000 に接続し、PlayMCP Endpoint に [ngrok アドレス]/kakao を登録します。

   • 一般的なウェブ API をテストする場合：

     python web_server.py
     

     • ウェブブラウザーや他のプログラムから http://localhost:5001/api/performances?stdate=... の形式でリクエストし、テストできます。