MCP cover image
See in Github
2025-04-06

Un servidor MCP para eventos en Brock. Ahora use Claude para ayudarlo a buscar eventos y más

1

Github Watches

0

Github Forks

0

Github Stars

🎓 Brock University Events MCP Server

Brock University

Your own assistant to help you network and be involved!

Model Context Protocol Claude License: MIT

📋 Overview

This MCP server connects to the Brock University events RSS feed and provides AI assistants with access to campus events. It allows students and faculty to easily discover relevant events, filter by date or category, and get comprehensive event details.

✨ Features

  • 🔄 Real-time data: Fetch and parse the Brock University events RSS feed
  • 🔍 Search capabilities: Find events by keyword
  • 📅 Timeline views: Get upcoming events for a specified number of days
  • 📆 Date filtering: Filter events by date or date range
  • Time filtering: Find events by time of day (morning, afternoon, evening)
  • 🏷️ Categories: Browse event categories and filter events accordingly
  • 📊 Special views: Get customized lists (this week, next week, weekend events)
  • 📝 Detailed info: Access comprehensive details for specific events

🛠️ Installation Guide

Prerequisites

  • 🐍 Python 3.10 or higher installed on your computer
  • 💻 Basic familiarity with command line operations

Step-by-Step Installation

1️⃣ Get the code
# Clone with Git
git clone https://github.com/yourusername/mcp-brockevents.git
cd mcp-brockevents

# Or download the ZIP and extract it
2️⃣ Install dependencies
# Install all required packages
pip install -r requirements.txt
3️⃣ Launch the server
# Start the MCP server
python brock_events_server.py

💡 The server is running successfully when there is no error output. Keep this terminal window open while using the server with Claude.

🔄 Connecting to Claude for Desktop

Setting up Claude Desktop

1️⃣ Install Claude for Desktop
  • Download from claude.ai/download
  • Follow the installation instructions for your operating system
2️⃣ Open the configuration file

Mac users:

  1. Click on the Claude menu at the top of your screen
  2. Select "Settings..."
  3. Click on "Developer" in the left sidebar
  4. Click "Edit Config"

Windows users:

  1. Open File Explorer
  2. Navigate to %APPDATA%\Claude\
  3. Create or edit the file claude_desktop_config.json
3️⃣ Add the server configuration

Copy and paste the following JSON into the configuration file:

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

⚠️ Important: Replace /REPLACE/WITH/FULL/PATH/TO/brock_events_server.py with the actual full path to the server file on your computer.

Examples:

  • Mac: /Users/yourusername/Downloads/mcp-brockevents/brock_events_server.py
  • Windows: C:\\Users\\yourusername\\Downloads\\mcp-brockevents\\brock_events_server.py
4️⃣ Finalize setup
  1. Save the configuration file
  2. Restart Claude for Desktop
  3. Verify connection: Look for the 🔨 hammer icon in the bottom right of the chat interface, indicating available tools

🧰 Available Tools

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

💬 Example Queries

Basic Queries
  • 📅 "What events are happening at Brock University this week?"
  • 🎵 "Are there any music events at Brock University?"
  • 📝 "What's happening on campus next Tuesday?"
  • 🎓 "Show me all the academic events at Brock"
  • 📋 "What categories of events are available at Brock University?"
  • 🔍 "Tell me more about the Blackout Gala event"
  • 🏢 "When and where is the next workshop happening?"
  • 👥 "Are there any social events this weekend?"
  • 🍔 "Show me events with free food"
  • 🤝 "What club meetings are happening this week?"
  • 📆 "What events are happening between March 15 and March 20?"
  • 🌙 "Show me evening events on Friday"
  • 📊 "What's happening next week at Brock?"

🔧 Customization Guide

📡 Changing the RSS Feed Source

You can configure this server to use event feeds from other universities:

Step 1: Locate the RSS Feed URL

  1. Open brock_events_server.py in any text editor
  2. Find line 14 where the RSS feed URL is defined:
    RSS_FEED_URL = "https://experiencebu.brocku.ca/events.rss"
    

Step 2: Replace with Your Preferred Feed

Replace the URL with another university's event feed:

University RSS/XML Feed URL
Brock University https://experiencebu.brocku.ca/events.rss
University of Guelph https://gryphlife.uoguelph.ca/Events.rss
Western University http://westernadvance.ca/calendar/western.xml

Step 3: Adapt the Parsing Logic (Advanced)

⚠️ Important Compatibility Note:

The server is specifically designed for Brock University's RSS feed structure. Different universities format their event data with unique:

  • Tag naming conventions
  • Date formats
  • Category systems
  • Event property names

If you change the RSS feed URL, you may need to modify the event parsing functions in the code to match the structure of your selected feed. The primary parsing logic is in the fetch_rss_feed() and related functions.

🚀 Advanced Use Cases

Students can quickly chat and find events based on their interests:

🔎 Professional Development

Users can upload their resume to find and filter professional networking events, and have Claude create elevator pitches about them. Perfect for preparing a game plan for networking events!

📱 Calendar Integration

Claude can filter events and create .ics files of selected events for users to add to their iCal or sync across their other calendars. Learn how to import .ics files to Google Calendar

📊 Schedule Optimization

Users can share an image of their personal schedule and ask "What events fit within my schedule for the month, can you find and filter them for me?" Claude will analyze available time slots and recommend compatible events.

⚠️ Troubleshooting

🛑 Server Won't Start
  1. Check Python version: Make sure you have Python 3.10+ installed

    python --version
    
  2. Dependency issues: Try reinstalling dependencies one by one

    pip install mcp[cli]
    pip install httpx feedparser python-dateutil pytz
    
  3. Permission errors: Make sure you have permission to run the script

🔌 Claude Not Connecting to Server
  1. Configuration file: Double-check your claude_desktop_config.json file

    • Ensure there are no syntax errors (missing commas, brackets, etc.)
    • Verify the path to the server file is correct and absolute
  2. Server running: Make sure your server is still running in the terminal

  3. Claude logs: Check Claude's logs for errors

    • On Mac: ~/Library/Logs/Claude/mcp*.log
    • On Windows: %APPDATA%\Claude\logs\mcp*.log
  4. Restart Claude: Sometimes a complete restart of Claude for Desktop resolves connection issues

📡 RSS Feed Issues

If the server starts but tools aren't working, the RSS feed might be unavailable or its format might have changed.

Try accessing https://events.brocku.ca/events/rss/ in your browser to check if it's accessible.

👥 Contributing

PRs Welcome Issues

Contributions are welcome! Feel free to submit pull requests or open issues if you have suggestions for improvements.

Developer Resources

📄 License

This project is licensed under the MIT License.

Copyright © 2024

License: MIT

相关推荐

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • Yusuf Emre Yeşilyurt
  • I find academic articles and books for research and literature reviews.

  • https://maiplestudio.com
  • Find Exhibitors, Speakers and more

  • Carlos Ferrin
  • Encuentra películas y series en plataformas de streaming.

  • Joshua Armstrong
  • Confidential guide on numerology and astrology, based of GG33 Public information

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • Elijah Ng Shi Yi
  • Advanced software engineer GPT that excels through nailing the basics.

  • lumpenspace
  • Take an adjectivised noun, and create images making it progressively more adjective!

  • Contraband Interactive
  • Emulating Dr. Jordan B. Peterson's style in providing life advice and insights.

  • https://zenepic.net
  • Embark on a thrilling diplomatic quest across a galaxy on the brink of war. Navigate complex politics and alien cultures to forge peace and avert catastrophe in this immersive interstellar adventure.

  • apappascs
  • Descubra la colección más completa y actualizada de servidores MCP en el mercado. Este repositorio sirve como un centro centralizado, que ofrece un extenso catálogo de servidores MCP de código abierto y propietarios, completos con características, enlaces de documentación y colaboradores.

  • ShrimpingIt
  • Manipulación basada en Micrypthon I2C del expansor GPIO de la serie MCP, derivada de AdaFruit_MCP230xx

  • modelcontextprotocol
  • Servidores de protocolo de contexto modelo

  • Mintplex-Labs
  • La aplicación AI de escritorio todo en uno y Docker con trapo incorporado, agentes de IA, creador de agentes sin código, compatibilidad de MCP y más.

  • ravitemer
  • Un poderoso complemento Neovim para administrar servidores MCP (protocolo de contexto del modelo)

  • jae-jae
  • Servidor MCP para obtener contenido de la página web con el navegador sin cabeza de dramaturgo.

  • patruff
  • Puente entre los servidores Ollama y MCP, lo que permite a LLM locales utilizar herramientas de protocolo de contexto del modelo

  • n8n-io
  • Plataforma de automatización de flujo de trabajo de código justo con capacidades de IA nativas. Combine el edificio visual con código personalizado, auto-anfitrión o nube, más de 400 integraciones.

  • WangRongsheng
  • 🧑‍🚀 全世界最好的 llM 资料总结(数据处理、模型训练、模型部署、 O1 模型、 MCP 、小语言模型、视觉语言模型) | Resumen de los mejores recursos del mundo.

    Reviews

    1 (1)
    Avatar
    user_W7xxSzRF
    2025-04-17

    As a dedicated mcp app user, I must say that mcp-brockevents by Aryan-Jhaveri has exceeded my expectations. It's highly efficient and user-friendly, making event management a breeze. The seamless integration and robust features save me a lot of time. Highly recommended!