MUSTer

An MCP server prepared for MUSTer. Enables LLM interaction with the M.U.S.T. (Macau University of Science and Technology) campus system.

python

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "cosmostima-muster_mcp": {
      "command": "UV_PATH_HERE",
      "args": [
        "--directory",
        "MCP_FOLDER_PATH_HERE",
        "run",
        "main.py"
      ],
      "env": {
        "MUSTER_PASSWORD": "YOUR_PASSWORD_HERE",
        "MUSTER_USERNAME": "YOUR_ID_HERE",
        "MUSTER_DOWNLOAD_PATH": "/Users/yourname/Downloads"
      }
    }
  }
}

You have a MUSTer MCP Server that enables an LLM to interact with the MUSTer campus system. With this server, you can log in to Wemust and Moodle, retrieve class schedules, check upcoming tasks, list courses, view assignment details, download course materials, and automatically open pages in an authenticated browser.

How to use

Use an MCP client to connect to the MUSTer MCP Server. The server exposes a set of tools that let you retrieve schedules, monitor deadlines, access course content, and download resources. You can automate common campus tasks such as fetching this week’s schedule, listing all courses, and downloading PPTs in bulk.

Key capabilities you can leverage include getting the current week’s class schedule, checking due dates and to-dos on Moodle, listing all Moodle courses, reading assignment or quiz details, downloading course materials, and opening pages in an automatically authenticated browser session for seamless access.

How to install

Prerequisites you need to have before installing the server are Python 3.12 or newer and a locally available Chrome/Chromedriver for Selenium automation.

Install the fast Python package manager used by the server tooling.

Clone the repository, install dependencies, and synchronize the package manager.

Run the MCP server locally using the provided configuration. The setup below demonstrates the required steps and environment variables used by the server.

# Prerequisites
# Ensure Python 3.12+ is installed
# Ensure Chrome/Chromedriver is available locally

# Install uv (the fast Python package manager)
# (Run the following if uv is not yet installed)
# pipx ensurepath
# pip install uv

# Clone the MCP repository and install dependencies
# (Use your preferred clone method)
git clone https://github.com/Cosmostima/MUSTer_MCP

cd MUSTer_MCP

uv sync

Configuration and security notes

The server requires login credentials to access campus systems. You will provide a MUSTER username and password through environment variables when running the MCP server. To customize the default download path for course materials, you can specify a download directory via an environment variable.

Environment variables you will use include MUSTER_USERNAME and MUSTER_PASSWORD as required, and MUSTER_DOWNLOAD_PATH as an optional override for the download location.

Two example configurations show how to run the server with the required credentials. Each example uses a placeholder for the path to the command and the folder where you want the MCP to operate.

Available tools

get_class_schedule

Fetches this week's class arrangements directly from the campus systems.

get_pending_events

Lists upcoming Moodle assignments and to-dos.

get_all_courses

Retrieves the names and links of all courses on the Moodle dashboard.

get_course_content

Reads assignment or quiz information within specific courses.

download_resource

Downloads files from Moodle resource pages, with bulk download support and folder selection.

open_URL_with_authorization

Opens a page in an automatically logged-in Chrome window, bypassing manual password entry.

get_current_time

Returns the current system timestamp.

Built by

VeilStrat

AI signals for GTM teams