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