AI导哈

大学活动服务器

一个连接大学活动RSS源的MCP服务器，提供实时活动数据查询、筛选和详细查看功能，适用于学生和教职工快速发现校园活动。

  • by Aryan-Jhaveri
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 aryan-jhaveri/mcp-brockevents

使用说明

🎓 布罗克大学活动MCP服务器

您自己的助手将帮助您建立人脉并参与其中！

📋 概述

此MCP服务器连接到布罗克大学活动RSS提要，并为AI助手提供访问校园活动的权限。它允许学生和教师轻松发现相关事件，按日期或类别过滤，并获得全面的事件详细信息。

✨ 特性

  • 🔄 实时数据：获取并解析布罗克大学事件RSS提要
  • 🔍 搜索功能：按关键字查找事件
  • 📅 日程表视图：获取指定天数内即将发生的事件
  • 📆 日期筛选：按日期或日期范围筛选事件
  • ⏰ 时间滤波：按时间查找事件（上午、下午、晚上）
  • 🏷️ 分类：浏览事件类别并相应地过滤事件
  • 📊 特别观点：获取自定义列表（本周、下周、周末活动）
  • 📝 详细信息：访问特定活动的全面详细信息

🛠️ 安装指南

先决条件

  • 🐍 您的计算机上安装了Python 3.10或更高版本
  • 💻 基本熟悉命令行操作

🛠️ 安装指南

按照以下步骤在您的计算机上运行布罗克大学活动MCP服务器：

先决条件

  • 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桌面

  1. 安装桌面版Claude： 如果您还没有，请从以下网址下载并安装Claude for Desktop应用程序 claude.ai/下载。按照屏幕上的说明进行操作。

  2. 打开配置文件：

    • 在Mac上： 打开Claude Desktop应用程序，单击屏幕顶部的Claude菜单，选择“设置…”，单击左侧边栏中的“开发人员”，然后单击“编辑配置”。（设置（⌘+，）→开发人员→ 编辑配置）
    • 在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"
      ]
    }
  }
}
    • 路径示例：
      • 雨衣： /Users/yourusername/Downloads/mcp-brockevents/brock_events_server.py
      • 窗户： C:\\Users\\yourusername\\Downloads\\mcp-brockevents\\brock_events_server.py

  4. 完成设置：

    • 保存 claude_desktop_config.json 文件。
    • 重新启动桌面版的Claude。
    • 验证连接： 重新启动后，寻找一个小锤子图标(🔨) 在Claude聊天界面的右下角。此图标表示MCP工具可用，服务器已连接。

现在，你的人工智能助手应该能够访问和使用布罗克大学活动MCP服务器提供的工具！

🧰 可用工具

Tool Description
get_upcoming_events(days) Get events for the specified number of days ahead
search_events(query) Search for events matching the keyword query
get_events_by_date(date) Get events on a specific date (format: YYYY-MM-DD)
get_events_by_date_range(start_date, end_date) Get events between two specified dates
get_events_by_time_of_day(date, time_range) Filter events by time of day (morning/afternoon/evening)
get_event_categories() List all available event categories with organized grouping
get_events_by_category(category) Get events in a specific category with fuzzy matching
get_event_details(query) Get detailed information about a specific event
get_events_this_week() Get all events occurring this week (Monday-Sunday)
get_events_next_week() Get all events occurring next week (Monday-Sunday)
get_weekend_events(date) Get events for the upcoming or specified weekend

💬 查询示例

Basic Queries
  • 📅 “本周布鲁克大学发生了什么事件？”
  • 🎵 “布鲁克大学有音乐活动吗？”
  • 📝 “下周二校园里会发生什么？”
  • 🎓 “给我看看布罗克的所有学术活动”
  • 📋 “布鲁克大学提供哪些类别的活动？”
  • 🔍 “告诉我更多关于停电晚会的信息”
  • 🏢 “下一次研讨会何时何地举行？”
  • 👥 “这个周末有什么社交活动吗？”
  • 🍔 “向我展示有免费食物的活动”
  • 🤝 “本周将举行哪些俱乐部会议？”
  • 📆 “3月15日至3月20日期间发生了什么事件？”
  • 🌙 “周五晚上给我看活动”
  • 📊 “布洛克下周会发生什么？”

🔧 定制指南

📡 Changing the RSS Feed Source

您可以将此服务器配置为使用其他大学的事件提要：

步骤1：找到RSS源URL

  1. 打开 brock_events_server.py 在任何文本编辑器中
  2. 找到定义RSS提要URL的第14行：
    RSS_FEED_URL = "https://experiencebu.brocku.ca/events.rss"

第二步：替换为您偏好的订阅源

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

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

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

⚠️ 重要兼容性说明:

该服务器是专门为布罗克大学的RSS提要结构设计的。不同的大学用独特的方式格式化他们的活动数据：

  • 标签命名约定
  • 日期格式
  • 分类系统
  • 事件属性名称

如果更改RSS提要URL，则可能需要修改代码中的事件解析函数，以匹配所选提要的结构。主要解析逻辑位于 fetch_rss_feed() 以及相关功能。

🚀 高级用例

学生可以根据自己的兴趣快速聊天和查找活动：

🔎 Professional Development

用户可以上传简历来查找和筛选专业社交活动，并让克劳德为他们创建电梯宣传。非常适合为社交活动准备游戏计划！

📱 Calendar Integration

Claude可以过滤事件并创建所选事件的.ics文件，供用户添加到他们的iCal中或在其他日历中同步。 了解如何将.ics文件导入Google日历

📊 Schedule Optimization

用户可以分享他们个人日程的图片，并询问“哪些活动符合我本月的日程安排，你能帮我找到并过滤吗？”克劳德将分析可用的时间段并推荐兼容的活动。

⚠️ 故障排除

🛑 Server Won't Start

  1. 检查Python版本：确保安装了Python 3.10+

    python --version

  2. 依赖性问题：尝试逐一重新安装依赖项

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

  3. 权限错误：确保您有运行脚本的权限

🔌 Claude Not Connecting to Server

  1. 配置文件：仔细检查你的 claude_desktop_config.json 文件

    • 确保没有语法错误（缺少逗号、括号等）
    • 验证服务器文件的路径是否正确且绝对

  2. 服务器正在运行：确保您的服务器仍在终端中运行

  3. 克劳德日志：检查克劳德的日志是否有错误

    • 在Mac上： ~/Library/Logs/Claude/mcp*.log
    • 在Windows上： %APPDATA%\Claude\logs\mcp*.log

  4. 重新启动克劳德：有时完全重新启动Claude for Desktop可以解决连接问题

📡 RSS Feed Issues

如果服务器启动但工具不起作用，则RSS提要可能不可用或其格式可能已更改。

尝试访问 https://events.brocku.ca/events/rss/ 在浏览器中检查它是否可访问。

👥 贡献

欢迎投稿！如果您有改进建议，请随时提交拉取请求或未决问题。

开发人员资源


Building MCP with LLMs
MCP Documentation

📄 许可证

该项目根据 MIT许可证.

版权所有©2024

相关 MCP