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
- Install uv (a fast Python package manager).
- 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/"
}
}
}