Muster MCP

🚀 MUSTer MCP Server

MUSTer用に用意されたMCPサーバーです。LLMが澳門科技大學（Macau University of Science and Technology）のキャンパスシステムとやり取りできるようになります。

English | 简体中文

現在、LLMは自動的にWemustとMoodleにログインし、授業スケジュールを取得し、コースのPPTや課題を照会し、やることリストを確認し、コース教材をダウンロードし、ページを自動的に開くことができます。

🚀 クイックスタート

このMCPサーバーを使用することで、LLMが澳門科技大學のキャンパスシステムとやり取りできるようになります。以下のセクションで詳細を説明します。

✨ 主な機能

• get_class_schedule：授業スケジュールを確認。今週の授業の予定を直接取得します。
• get_pending_events：DDLを確認。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/"
      }
    }
}