🎓 Brock University Events MCP Server

🎓 Brock University イベント MCP サーバー

📋 概要

この MCP サーバーは Brock University のイベント RSS フィードに接続し、AI アシスタントがキャンパスのイベントにアクセスできるようにします。学生や教職員は、関連するイベントを簡単に見つけたり、日付やカテゴリーで絞り込んだり、イベントの詳細を確認したりできます。

✨ 機能

• 🔄 リアルタイムデータ：Brock University のイベント RSS フィードを取得して解析します
• 🔍 検索機能：キーワードでイベントを検索します
• 📅 期間別表示：指定した日数以内に開催されるイベントを取得します
• 📆 日付フィルター：日付または期間でイベントを絞り込みます
• ⏰ 時間フィルター：時間帯（午前、午後、夕方）でイベントを検索します
• 🏷️ カテゴリー：イベントカテゴリーを閲覧し、カテゴリーに応じてイベントを絞り込みます
• 📊 特別な表示：カスタマイズされた一覧（今週、来週、週末のイベント）を取得します
• 📝 詳細情報：特定のイベントの詳細情報にアクセスします

🛠️ インストールガイド

前提条件

• 🐍 コンピューターに Python 3.10 以降がインストールされていること
• 💻 コマンドライン操作の基本的な知識

🛠️ インストールガイド

以下の手順に従って、Brock University Events MCP Server をコンピューターで実行してください。

前提条件

• Python 3.10 以降： 互換性のあるバージョンの Python がインストールされていることを確認してください。
• コマンドラインの基本的な知識： ターミナルまたはコマンドプロンプトを開き、基本的なコマンドを実行できる必要があります。

インストール手順

1. コードを取得します：

   • Git を使用する場合： Git がインストールされている場合は、ターミナルを開いて次のコマンドを実行します。

     git clone https://github.com/Aryan-Jhaveri/mcp-brockevents
     cd mcp-brockevents
     

   • ZIP をダウンロードする場合： GitHub ページからプロジェクトを ZIP ファイルとしてダウンロードし、コンピューター上のフォルダーに展開することもできます。その後、ターミナルを開き、cd コマンドを使用してそのフォルダーに移動します。

2. 依存関係をインストールします：

   • ターミナルでプロジェクトディレクトリ（mcp-brockevents）に移動し、次のコマンドを実行して必要な Python パッケージをすべてインストールします。

     pip install -r requirements.txt
     

Claude Desktop のセットアップ

1. Claude for Desktop をインストールする： まだインストールしていない場合は、claude.ai/download から Claude for Desktop アプリケーションをダウンロードしてインストールします。画面の指示に従ってください。

2. 設定ファイルを開く：

   • Mac の場合： Claude Desktop アプリを開き、画面上部の Claude メニューをクリックして「Settings...」を選択し、左側のサイドバーで「Developer」をクリックしてから、「Edit Config」をクリックします。（Settings（⌘ + ,）→ Developer → Edit Config）
   • Windows の場合： エクスプローラーを開き、%APPDATA%\Claude\ に移動して、claude_desktop_config.json という名前のファイルを探すか、新規作成します。

3. サーバー設定を追加する：

   • 以下の JSON 構造をコピーして、claude_desktop_config.json ファイルに貼り付けます。
   • 重要： /REPLACE/WITH/FULL/PATH/TO/brock_events_server.py を、お使いのコンピューター上にある brock_events_server.py ファイルの実際のフルパスに置き換えてください。

   {
     "mcpServers": {
       "brocku-events": {
         "command": "python",
         "args": [
           "/REPLACE/WITH/FULL/PATH/TO/brock_events_server.py"
         ]
       }
     }
   }
   

   • パスの例：
     • Mac： /Users/yourusername/Downloads/mcp-brockevents/brock_events_server.py
     • Windows： C:\\Users\\yourusername\\Downloads\\mcp-brockevents\\brock_events_server.py

4. セットアップを完了する：

   • claude_desktop_config.json ファイルを保存します。
   • Claude for Desktop を再起動します。
   • 接続を確認する： 再起動後、Claude のチャット画面の右下に小さなハンマーアイコン（🔨）が表示されていることを確認します。このアイコンは、MCP ツールが利用可能で、サーバーに接続されていることを示します。

これで、AI アシスタントが Brock University Events MCP Server のツールにアクセスして使用できるようになります！

🧰 利用可能なツール

## 💬 クエリの例

基本的なクエリ

• 📅 「今週、Brock Universityではどんなイベントが開催されますか？」
• 🎵 「Brock Universityで音楽イベントはありますか？」
• 📝 「来週の火曜日、キャンパスでは何が開催されますか？」
• 🎓 「Brockの学術イベントをすべて表示してください」
• 📋 「Brock Universityでは、どのようなカテゴリのイベントがありますか？」
• 🔍 「Blackout Galaイベントについて詳しく教えてください」
• 🏢 「次のワークショップはいつ、どこで開催されますか？」
• 👥 「今週末、交流イベントはありますか？」
• 🍔 「無料の食事があるイベントを表示してください」
• 🤝 「今週、どのようなクラブのミーティングがありますか？」
• 📆 「3月15日から3月20日まで、どんなイベントがありますか？」
• 🌙 「金曜日の夜のイベントを表示してください」
• 📊 「来週、Brockでは何が開催されますか？」

🔧 カスタマイズガイド

📡 RSS フィードソースの変更

このサーバーは、他の大学のイベントフィードを使用するように設定できます。

ステップ 1：RSS フィードの URL を確認する

1. テキストエディターで brock_events_server.py を開きます
2. RSS フィードの URL が定義されている14行目を探します。

   RSS_FEED_URL = "https://experiencebu.brocku.ca/events.rss"
   

ステップ 2：任意のフィードに置き換える

URLを別の大学のイベントフィードに置き換えます。

大学	RSS/XML フィード URL
Brock University	https://experiencebu.brocku.ca/events.rss
University of Guelph	https://gryphlife.uoguelph.ca/Events.rss
Western University	http://westernadvance.ca/calendar/western.xml

ステップ 3：解析ロジックを調整する（上級者向け）

⚠️ 互換性に関する重要な注意事項：

このサーバーは、Brock UniversityのRSSフィード構造に合わせて設計されています。大学によってイベントデータの形式は異なり、次の項目にも独自の形式が使われています。

• タグの命名規則
• 日付形式
• カテゴリ体系
• イベントのプロパティ名

RSSフィードのURLを変更した場合、選択したフィードの構造に合わせて、コード内のイベント解析関数を修正する必要があります。主な解析ロジックは fetch_rss_feed() 関数と関連関数にあります。

🚀 高度な活用例

学生は、自分の興味に基づいてすばやくチャットし、イベントを見つけられます。

🔎 キャリア開発

ユーザーは履歴書をアップロードして、キャリアに役立つネットワーキングイベントを探したり、絞り込んだりできます。また、Claudeに自分を紹介するエレベーターピッチを作成してもらうこともできます。ネットワーキングイベントに向けた行動計画を立てるのに最適です！

📱 カレンダー連携

Claudeはイベントを絞り込み、選択したイベントの .ics ファイルを作成できます。ユーザーはそれをiCalに追加したり、他のカレンダーと同期したりできます。.ics ファイルを Google Calendar にインポートする方法

📊 スケジュールの最適化

ユーザーは自分のスケジュールの画像を共有して、「今月のスケジュールに合うイベントはありますか？探して絞り込んでもらえますか？」と尋ねることができます。Claudeは空き時間を分析し、都合の合うイベントを提案します。

## ⚠️ トラブルシューティング

🛑 サーバーが起動しない

1. Python のバージョンを確認する：Python 3.10 以降がインストールされていることを確認してください。

   python --version
   

2. 依存関係の問題：依存関係を1つずつ再インストールしてみてください。

   pip install mcp[cli]
   pip install httpx feedparser python-dateutil pytz
   

3. 権限エラー：スクリプトを実行する権限があることを確認してください。

🔌 Claude がサーバーに接続しない

1. 設定ファイル：claude_desktop_config.json ファイルを再確認してください。

   • 構文エラー（カンマや括弧の不足など）がないことを確認してください。
   • サーバーファイルへのパスが正しく、絶対パスであることを確認してください。

2. サーバーの実行状態：サーバーがターミナルで引き続き実行中であることを確認してください。

3. Claude のログ：Claude のログでエラーを確認してください。

   • Mac の場合：~/Library/Logs/Claude/mcp*.log
   • Windows の場合：%APPDATA%\Claude\logs\mcp*.log

4. Claude を再起動する：Claude for Desktop を完全に再起動すると、接続の問題が解決する場合があります。

📡 RSS フィードの問題

サーバーは起動するもののツールが動作しない場合、RSS フィードが利用できないか、形式が変更されている可能性があります。

ブラウザーで https://events.brocku.ca/events/rss/ にアクセスし、利用可能か確認してください。

👥 貢献

貢献を歓迎します！改善の提案がある場合は、プルリクエストを送信するか、イシューを作成してください。

開発者向けリソース

📄 ライセンス