🎓 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 助手应该能够访问并使用布鲁克大学活动 MCP 服务提供的工具了！

🧰 可用工具

## 💬 示例查询

基本查询

• 📅 “布鲁克大学本周有哪些活动？”
• 🎵 “布鲁克大学有音乐活动吗？”
• 📝 “下周二校园里有什么活动？”
• 🎓 “显示布鲁克大学的所有学术活动”
• 📋 “布鲁克大学有哪些活动类别？”
• 🔍 “详细介绍一下 Blackout Gala 活动”
• 🏢 “下一个研讨会何时何地举行？”
• 👥 “本周末有社交活动吗？”
• 🍔 “显示提供免费食物的活动”
• 🤝 “本周有哪些社团会议？”
• 📆 “3 月 15 日至 3 月 20 日期间有哪些活动？”
• 🌙 “显示周五晚上的活动”
• 📊 “布鲁克大学下周有什么活动？”

🔧 自定义指南

📡 更改 RSS Feed 来源

你可以配置此服务，以使用其他大学的活动 Feed：

步骤 1：找到 RSS Feed URL

1. 用任意文本编辑器打开 brock_events_server.py
2. 找到第 14 行定义 RSS Feed URL 的位置：

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

步骤 2：替换为你首选的 Feed

将 URL 替换为另一所大学的活动 Feed：

大学	RSS/XML Feed URL
布鲁克大学	https://experiencebu.brocku.ca/events.rss
圭尔夫大学	https://gryphlife.uoguelph.ca/Events.rss
西安大略大学	http://westernadvance.ca/calendar/western.xml

步骤 3：调整解析逻辑（高级）

⚠️ 重要兼容性说明：

此服务是专为布鲁克大学的 RSS Feed 结构设计的。不同大学的活动数据格式各不相同，包括：

• 标签命名惯例
• 日期格式
• 类别系统
• 活动属性名称

如果更改 RSS Feed URL，你可能需要修改代码中的活动解析函数，以匹配所选 Feed 的结构。主要解析逻辑位于 fetch_rss_feed() 和相关函数中。

🚀 高级用例

学生可以根据自己的兴趣快速交流并查找活动：

🔎 职业发展

用户可以上传简历，查找并筛选职业人脉拓展活动，还可以让 Claude 为他们撰写电梯演讲。非常适合为人脉拓展活动制定计划！

📱 日历集成

Claude 可以筛选活动，并为用户选定的活动创建 .ics 文件，方便用户添加到 iCal，或与其他日历同步。了解如何将 .ics 文件导入 Google 日历

📊 日程优化

用户可以分享个人日程的图片，并询问：“这个月有哪些活动适合我的日程？你能帮我查找并筛选出来吗？”Claude 会分析可用时段，并推荐时间合适的活动。

## ⚠️ 故障排除

🛑 服务无法启动

1. 检查 Python 版本：确保已安装 Python 3.10 或更高版本

   python --version
   

2. 依赖问题：尝试逐个重新安装依赖

   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/，检查其是否可访问。

👥 参与贡献

欢迎贡献！如果你有改进建议，欢迎提交拉取请求或提出问题。

开发者资源

📄 许可证