🎓 Brock University Events MCP Server

🎓 Brock University Events MCP Server

site icon
2025.04.06 0
Python校园活动管理日程管理日程管理
mcp-brockevents 是一个连接 Brock University 活动 RSS 源的 MCP 服务器,为 AI 助手提供校园活动访问能力。它允许学生和教职员工轻松发现相关活动,按日期或类别筛选,并获取全面的活动详情。
View on GitHub

Overview

📋 基本能力

产品定位

mcp-brockevents 是一个专门为 Brock University 设计的校园活动信息管理服务,通过 RSS 源提供实时活动数据,帮助用户高效管理和参与校园活动。

核心功能

  • 🔄 实时数据:获取并解析 Brock University 活动的 RSS 源
  • 🔍 搜索能力:通过关键词查找活动
  • 📅 时间线视图:获取指定天数内的即将举行的活动
  • 📆 日期筛选:按日期或日期范围筛选活动
  • 时间筛选:按时间段(上午、下午、晚上)筛选活动
  • 🏷️ 类别浏览:浏览活动类别并按类别筛选活动
  • 📊 特殊视图:获取定制列表(本周、下周、周末活动)
  • 📝 详细信息:获取特定活动的全面详情

适用场景

  • 学生和教职员工查找和参与校园活动
  • 按兴趣或时间安排筛选活动
  • 获取活动详情并管理个人日程

🛠️ 使用教程

使用依赖

  • 🐍 Python 3.10 或更高版本
  • 💻 基本命令行操作知识

安装教程

  1. 获取代码
git clone https://github.com/yourusername/mcp-brockevents.git
cd mcp-brockevents
  1. 安装依赖
pip install -r requirements.txt
  1. 启动服务器
python brock_events_server.py

调试方式

  1. 检查 Python 版本
python --version
  1. 重新安装依赖
pip install mcp[cli]
pip install httpx feedparser python-dateutil pytz
  1. 检查服务器运行状态 确保服务器在终端中运行且无错误输出

🧰 可用工具

工具 描述
get_upcoming_events(days) 获取指定天数内的即将举行的活动
search_events(query) 搜索匹配关键词的活动
get_events_by_date(date) 获取特定日期的活动(格式:YYYY-MM-DD)
get_events_by_date_range(start_date, end_date) 获取两个指定日期之间的活动
get_events_by_time_of_day(date, time_range) 按时间段筛选活动(上午/下午/晚上)
get_event_categories() 列出所有可用活动类别
get_events_by_category(category) 获取特定类别的活动
get_event_details(query) 获取特定活动的详细信息
get_events_this_week() 获取本周的所有活动(周一至周日)
get_events_next_week() 获取下周的所有活动(周一至周日)
get_weekend_events(date) 获取即将到来或指定周末的活动

⚠️ 常见问题解答

服务器无法启动

  1. 检查 Python 版本是否为 3.10 或更高
  2. 尝试逐个重新安装依赖
  3. 确保有运行脚本的权限

Claude 无法连接到服务器

  1. 检查配置文件 claude_desktop_config.json 是否有语法错误
  2. 确保服务器仍在终端中运行
  3. 检查 Claude 的日志文件
  4. 完全重启 Claude for Desktop

RSS 源问题

如果工具无法工作,可能是 RSS 源不可用或其格式已更改。尝试在浏览器中访问 https://events.brocku.ca/events.rss/ 检查是否可访问。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。