Science Tokyo LMS MCP

東京科学大学 (Science Tokyo) の LMS を操作する MCP (Model Context Protocol) サーバです． 講義資料のダウンロードや課題締切の確認などを，MCP クライアント (Claude 等) から ツールとして呼び出せるようにします．

対象と基盤

• 対象 LMS: Science Tokyo LMS (https://lms.s.isct.ac.jp/<年度>/)

• 基盤: Moodle (確認済み)．年度ごとにパスが分かれる (例: /2025/)．

• 方式: Moodle Web Services REST API + モバイルトークン認証． ブラウザ巡回 (スクレイピング) ではなく公式 API を用いるため安定・高速．

• データ取得層 (client/moodle_client.py) は実装済みですが，実トークンでの 動作確認は未実施です (下記 science-tokyo-lms-login で取得後に検証してください)．

Related MCP server: Moodle MCP Server

認証方針 (MFA 必須前提)

Science Tokyo は SAML2 SSO (isct.ex-tic.com / MFA 必須) で保護されています． そのためパスワードによるトークン発行は使えません．代わりに Moodle モバイルアプリと 同じ launch フローを用います．

# 初回のみ: ブラウザが開くので SSO ログイン (MFA 含む) を完了する
# → モバイルトークンを取得し keyring に保存する
uv run science-tokyo-lms-login

取得したトークンは keyring (利用不可なら .auth/wstoken，いずれも .gitignore 済み) に 保存され，以降はブラウザ不要で Web Services API を呼び出します．トークンが失効したら 再度上記コマンドを実行してください．

セットアップ

uv sync                              # 依存関係の同期
uv run playwright install chromium   # 使用するブラウザを取得 (chromium / firefox / webkit)
cp .env.example .env                 # 必要に応じて編集 (年度・ブラウザ等)

設定 (.env)

主な設定項目 (環境変数 STLMS_*，.env で指定可)．

keyring (パスワードストア) が使えない環境では STLMS_TOKEN_BACKEND=file を指定すると， トークンを .auth/wstoken (.gitignore 済み，パーミッション 0600) に保存します．

起動

uv run science-tokyo-lms-mcp         # MCP サーバを stdio で起動

MCP クライアント (例: Claude Desktop / Claude Code) には以下のように登録します．

{
  "mcpServers": {
    "science-tokyo-lms": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/ScienceTokyoLMS-mcp", "science-tokyo-lms-mcp"]
    }
  }
}

提供ツール

課題の提出済み判定は別 API が必要なため，現状 submitted は常に false です (今後 mod_assign_get_submission_status で対応予定)．

主な Moodle Web Services 関数の対応

ディレクトリ構成

src/science_tokyo_lms_mcp/
├── server.py              # FastMCP サーバ (エントリポイント)
├── login.py               # 初回トークン取得 CLI
├── config.py              # 設定 (環境変数 STLMS_*)
├── models.py              # データモデル
├── auth/
│   ├── session.py         # Playwright 永続セッション管理
│   └── token.py           # モバイルトークンの取得・保管 (keyring)
├── client/
│   ├── base.py            # LMSClient プロトコル
│   ├── moodle_client.py   # Moodle Web Services 実装 (既定)
│   └── playwright_client.py  # スクレイピング方式のフォールバック
└── tools/                 # MCP ツール (courses / materials / deadlines / announcements)

開発

uv run ruff format .      # フォーマット
uv run ruff check .       # Lint
uv run ty check           # 型チェック
uv run pytest             # テスト

セキュリティ

• 認証情報・cookie・トークン・ダウンロード資料は コミットしない (.gitignore 済み)．

• パスワードはコード・設定に保持せず，SSO は永続プロファイルに，トークンは keyring に委ねます．

• リポジトリは private 運用 を推奨します．