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

<div align="center">

您自己的助手，帮助您建立联系并参与其中！

</div>

📋 概述

此 MCP 服务器连接到布鲁克大学活动 RSS feed，并为 AI 助手提供访问校园活动的功能。 它允许学生和教职员工轻松发现相关活动，按日期或类别进行过滤，并获取全面的活动详细信息。

✨ 功能

• 🔄 实时数据: 获取并解析布鲁克大学活动 RSS feed
• 🔍 搜索功能: 通过关键字查找活动
• 📅 时间线视图: 获取指定天数的即将发生的活动
• 📆 日期过滤: 按日期或日期范围过滤活动
• ⏰ 时间过滤: 按一天中的时间（上午、下午、晚上）查找活动
• 🏷️ 类别: 浏览活动类别并相应地过滤活动
• 📊 特殊视图: 获取自定义列表（本周、下周、周末活动）
• 📝 详细信息: 访问特定活动的全面详细信息

🛠️ 安装指南

前提条件

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

分步安装

<details open> <summary><b>1️⃣ 获取代码</b></summary>

# 使用 Git 克隆
git clone https://github.com/yourusername/mcp-brockevents.git
cd mcp-brockevents

# 或者下载 ZIP 并解压缩

</details>

<details open> <summary><b>2️⃣ 安装依赖项</b></summary>

# 安装所有必需的软件包
pip install -r requirements.txt

</details>

<details open> <summary><b>3️⃣ 启动服务器</b></summary>

# 启动 MCP 服务器
python brock_events_server.py

💡 当没有错误输出时，服务器成功运行。 在 Claude 中使用服务器时，请保持此终端窗口打开。 </details>

🔄 连接到 Claude 桌面版

设置 Claude 桌面版

<details open> <summary><b>1️⃣ 安装 Claude 桌面版</b></summary>

• 从 claude.ai/download 下载
• 按照适用于您操作系统的安装说明进行操作 </details>

<details open> <summary><b>2️⃣ 打开配置文件</b></summary>

Mac 用户:

1. 单击屏幕顶部的 Claude 菜单
2. 选择“设置...”
3. 单击左侧边栏中的“开发者”
4. 单击“编辑配置”

Windows 用户:

1. 打开文件资源管理器
2. 导航到 %APPDATA%\Claude\
3. 创建或编辑文件 claude_desktop_config.json </details>

<details open> <summary><b>3️⃣ 添加服务器配置</b></summary>

将以下 JSON 复制并粘贴到配置文件中：

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

⚠️ 重要提示: 将 /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 </details>

<details open> <summary><b>4️⃣ 完成设置</b></summary>

1. 保存配置文件
2. 重新启动 Claude 桌面版
3. 验证连接: 在聊天界面右下角查找 🔨 锤子图标，表示可用工具 </details>

🧰 可用工具

<div align="center"> <table> <tr> <th>工具</th> <th>描述</th> </tr> <tr> <td><code>get_upcoming_events(days)</code></td> <td>获取指定天数内的活动</td> </tr> <tr> <td><code>search_events(query)</code></td> <td>搜索与关键字查询匹配的活动</td> </tr> <tr> <td><code>get_events_by_date(date)</code></td> <td>获取特定日期的活动（格式：YYYY-MM-DD）</td> </tr> <tr> <td><code>get_events_by_date_range(start_date, end_date)</code></td> <td>获取两个指定日期之间的活动</td> </tr> <tr> <td><code>get_events_by_time_of_day(date, time_range)</code></td> <td>按一天中的时间（上午/下午/晚上）过滤活动</td> </tr> <tr> <td><code>get_event_categories()</code></td> <td>列出所有可用的活动类别，并进行有组织的分类</td> </tr> <tr> <td><code>get_events_by_category(category)</code></td> <td>获取特定类别的活动，并进行模糊匹配</td> </tr> <tr> <td><code>get_event_details(query)</code></td> <td>获取有关特定活动的详细信息</td> </tr> <tr> <td><code>get_events_this_week()</code></td> <td>获取本周（周一至周日）发生的所有活动</td> </tr> <tr> <td><code>get_events_next_week()</code></td> <td>获取下周（周一至周日）发生的所有活动</td> </tr> <tr> <td><code>get_weekend_events(date)</code></td> <td>获取即将到来的或指定的周末的活动</td> </tr> </table> </div>

💬 示例查询

<details open> <summary><b>基本查询</b></summary>

• 📅 “本周在布鲁克大学有哪些活动？”
• 🎵 “布鲁克大学有音乐活动吗？”
• 📝 “下周二校园里有什么活动？”
• 🎓 “向我展示布鲁克的所有学术活动”
• 📋 “布鲁克大学有哪些活动类别？”
• 🔍 “告诉我更多关于 Blackout Gala 活动的信息”
• 🏢 “下一次研讨会的时间和地点是什么？”
• 👥 “这个周末有什么社交活动吗？”
• 🍔 “向我展示有免费食物的活动”
• 🤝 “本周有哪些俱乐部会议？”
• 📆 “3 月 15 日至 3 月 20 日之间有哪些活动？”
• 🌙 “向我展示星期五晚上的活动”
• 📊 “下周在布鲁克有什么活动？” </details>

🔧 自定义指南

<details open> <summary><b>📡 更改 RSS Feed 源</b></summary>

您可以配置此服务器以使用来自其他大学的活动 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() 和相关函数中。

</details>

🚀 高级用例

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

<details open> <summary><b>🔎 职业发展</b></summary>

用户可以上传他们的简历来查找和过滤专业社交活动，并让 Claude 创建关于他们的电梯演讲。 非常适合为社交活动准备游戏计划！ </details>

<details open> <summary><b>📱 日历集成</b></summary>

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

<details open> <summary><b>📊 安排优化</b></summary>

用户可以分享他们的个人日程安排的图片，并询问“本月有哪些活动适合我的日程安排，你能找到并为我过滤它们吗？” Claude 将分析可用的时间段并推荐兼容的活动。 </details>

⚠️ 故障排除

<details> <summary><b>🛑 服务器无法启动</b></summary>

1. 检查 Python 版本: 确保您已安装 Python 3.10+

   python --version
   

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

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

3. 权限错误: 确保您有运行脚本的权限 </details>

<details> <summary><b>🔌 Claude 无法连接到服务器</b></summary>

1. 配置文件: 仔细检查您的 claude_desktop_config.json 文件

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

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

3. Claude 日志: 检查 Claude 的日志以查找错误

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

4. 重新启动 Claude: 有时完全重新启动 Claude 桌面版可以解决连接问题 </details>

<details> <summary><b>📡 RSS Feed 问题</b></summary>

如果服务器启动但工具无法正常工作，则 RSS feed 可能不可用或其格式可能已更改。

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

👥 贡献

<div align="center">

</div>

欢迎贡献！ 如果您有改进建议，请随时提交 pull request 或打开 issue。

开发者资源

<div align="center"> <table> <tr> <td align="center"> <a href="https://modelcontextprotocol.io/tutorials/building-mcp-with-llms"> <img src="https://mintlify.s3.us-west-1.amazonaws.com/mcp/images/claude-desktop-mcp-plug-icon.svg" width="80" alt="MCP with LLMs"><br> <b>使用 LLM 构建 MCP</b> </a> </td> <td align="center"> <a href="https://modelcontextprotocol.io/docs/concepts/architecture"> <img src="https://mintlify.s3.us-west-1.amazonaws.com/mcp/images/claude-desktop-mcp-hammer-icon.svg" width="80" alt="MCP Docs"><br> <b>MCP 文档</b> </a> </td> </tr> </table> </div>

📄 许可证

<div align="center">

本项目根据 MIT 许可证 获得许可。

版权所有 © 2024

</div>