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.

🚀 Quick Start

The MUSTer MCP Server allows LLMs to interact with the M.U.S.T. campus system. With this server, you can perform various operations such as getting class schedules, checking assignment deadlines, and downloading course materials.

✨ Features

• 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.

🔧 Technical Details

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

💻 Usage Examples

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/"
      }
    }
}