Cosmostima/MUSTer_MCP

MUSTer MCP Server

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

English |

Now, LLMs can automatically log in to Wemust and Moodle, retrieve class schedules, query course PPTs, assignments, view to-do items, download course materials, and automatically open pages.

Tools Overview

• get_class_schedule: Check Schedule. Directly fetches this week's class arrangements.
• get_pending_events: Check DDL. Lists upcoming assignments and to-dos on Moodle.
• get_all_courses: List Courses. Gets the names and links of all courses on the Moodle dashboard.
• get_course_content: Check Details. Reads assignment or quiz information within specific courses.
• download_resource: Download Courseware. Downloads files from Moodle resource pages (especially convenient for bulk downloading PPTs). This also allows the large model to select a specific folder.
• open_URL_with_authorization: Open without password. Directly pops up an automatically logged-in Chrome window, no need to manually enter account password, automatically opens the specified page.
• get_current_time: Gets the current system timestamp.

Environmental Dependencies

• Python 3.12+
• Locally available Chrome/Chromedriver (for Selenium).
• Environment variables: MUSTER_USERNAME, MUSTER_PASSWORD (required); MUSTER_DOWNLOAD_PATH (optional, default download path, defaults to ~/Downloads).

Installation

1. Install uv (a fast Python package manager).
2. Clone the repository and install dependencies:

git clone https://github.com/Cosmostima/MUSTer_MCP

cd MUSTer_MCP

uv sync

MCP Client Configuration Example

{
  "mcpServers": {
    "muster": {
      "command": "UV_PATH_HERE",
      "args": [
        "--directory",
        "MCP_FOLDER_PATH_HERE",
        "run",
        "main.py"
      ],
      "env": {
              "MUSTER_USERNAME": "YOUR_ID_HERE",
              "MUSTER_PASSWORD": "YOUR_PASSWORD_HERE"
      }
    }
}

If you need to customize the default download path, you can add MUSTER_DOWNLOAD_PATH :

{
  "mcpServers": {
    "muster": {
      "command": "UV_PATH_HERE",
      "args": [
        "--directory",
        "MCP_FOLDER_PATH_HERE",
        "run",
        "main.py"
      ],
      "env": {
              "MUSTER_USERNAME": "YOUR_ID_HERE",
              "MUSTER_PASSWORD": "YOUR_PASSWORD_HERE",
              "MUSTER_DOWNLOAD_PATH": "/Users/cosmos/Desktop/"
      }
    }
}