Muster MCP

🚀 MUSTer MCP 服务器

MUSTer MCP 服务器是专门为澳门科技大学（M.U.S.T.）用户打造的一款服务，它能让大语言模型（LLM）与校园系统实现交互，实现自动登录 Wemust 和 Moodle 平台，获取课程表、查询课程 PPT、作业信息、查看待办事项、下载课程资料以及自动打开相关页面等功能。

English | 简体中文

🚀 快速开始

现在，大语言模型可以自动登录 Wemust 和 Moodle，获取课程表、查询课程 PPT、作业信息、查看待办事项、下载课程资料以及自动打开相关页面。

✨ 主要特性

• get_class_schedule：查询课程表。可直接获取本周的课程安排。
• get_pending_events：查看截止日期。列出 Moodle 上即将到来的作业和待办事项。
• get_all_courses：列出所有课程。获取 Moodle 仪表盘上所有课程的名称和链接。
• get_course_content：查看课程详情。读取特定课程内的作业或测验信息。
• download_resource：下载课件。从 Moodle 资源页面下载文件（特别适合批量下载 PPT），还支持大模型选择特定文件夹。
• open_URL_with_authorization：免密码打开页面。直接弹出自动登录的 Chrome 窗口，无需手动输入账号密码，自动打开指定页面。
• get_current_time：获取当前系统时间戳。

📦 安装指南

环境依赖

• Python 3.12+
• 本地可用的 Chrome/Chromedriver（用于 Selenium）
• 环境变量：MUSTER_USERNAME、MUSTER_PASSWORD（必需）；MUSTER_DOWNLOAD_PATH（可选，默认下载路径，默认为 ~/Downloads）

安装步骤

1. 安装 uv（一个快速的 Python 包管理器）。
2. 克隆仓库并安装依赖：

git clone https://github.com/Cosmostima/MUSTer_MCP
cd MUSTer_MCP
uv sync

💻 使用示例

MCP 客户端配置示例

{
  "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：

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