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 命令。

1. 安装依赖项：

- 将您的终端放在项目目录中(mcp-brockevents)，运行以下命令安装所有必需的Python包：

     pip install -r requirements.txt

设置Claude桌面

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

1. 打开配置文件：

- 在Mac上： 打开Claude Desktop应用程序，单击屏幕顶部的Claude菜单，选择“设置…”，单击左侧边栏中的“开发人员”，然后单击“编辑配置”。（设置（⌘+，）→开发人员→ 编辑配置） - 在Windows上： 打开文件资源管理器，导航到 %APPDATA%\Claude\，并查找或创建名为的文件 claude_desktop_config.json.

1. 添加服务器配置：

- 将以下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

1. 完成设置：

- 保存 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替换为另一所大学的活动提要：

步骤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

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

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

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

🔌 Claude Not Connecting to Server

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

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

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

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

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

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

📡 RSS Feed Issues

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

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

👥 贡献

 

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

开发人员资源

Building MCP with LLMs

MCP Documentation

📄 许可证

该项目根据 MIT许可证.

版权所有©2024