Skip to main content
Glama

CAU e-Class MCP

중앙대학교 e-Class를 MCP 클라이언트에서 다루는 Rust 서버입니다.

e-Class 로그인은 브라우저에서 한 번만 합니다. 강좌, 공지, 과제, 자료 조회와 다운로드, 과제 제출은 HTTP로 처리합니다. OZ 강의계획서 PDF 저장을 포함한 모든 MCP 도구를 Rust 실행파일 하나로 제공합니다.

e-Class MCP 데모

구조

구성

역할

Rust eclass-mcp

MCP stdio 서버, 31개 도구, HTTP 조회·다운로드·OZ PDF 저장·PDF 텍스트·과제 제출

session.json

.cau.ac.kr 쿠키 저장소. Unix에서 소유자 전용 0600

Related MCP server: canvas-session-mcp

Rust MCP 설치

GitHub Releases에서 운영체제에 맞는 실행파일을 받습니다. 설치 스크립트가 SHA-256을 검증하며 Rust, Python, uv가 필요 없습니다.

macOS / Linux

macOS는 Apple Silicon, Linux는 glibc 2.35 이상이 설치된 x86_64와 ARM64를 지원합니다.

curl -fsSL https://raw.githubusercontent.com/givemethatsewon/cau-eclass-mcp/main/rust/install.sh | bash

Windows x64 PowerShell

irm https://raw.githubusercontent.com/givemethatsewon/cau-eclass-mcp/main/rust/install.ps1 | iex

설치가 끝나면 출력된 onboard 명령을 실행하세요. PATH에 설치 폴더를 추가하면 eclass-mcp로 실행할 수 있습니다.

소스에서 빌드

cd rust
cargo build --release
./target/release/eclass-mcp-rs onboard --client claude

배포와 업데이트, 서명 정책은 rust/README.md, rust/RELEASING.md를 참고하세요.

로그인

eclass-mcp onboard --client claude
# 또는
eclass-mcp login

전용 Chrome/Edge/Chromium 프로필(~/.cau-eclass/chrome-profile)이 열립니다. e-Class에 직접 로그인하면 쿠키 DB에서 세션을 읽어 저장합니다.

eclass-mcp doctor
eclass-mcp config --client claude

doctor는 Canvas 세션과 LearningX 토큰을 따로 확인해 canvas_ok, learningx_ok, next_action을 보여 줍니다. 이름·학번·쿠키는 찍지 않습니다. config는 설정을 출력하고 클라이언트 파일은 건드리지 않습니다.

로그인 옵션

# 이미 로그인된 Chrome 프로필의 쿠키만 읽기
eclass-mcp login --no-launch

# 다른 브라우저/프로필
eclass-mcp login --browser-path "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge"
eclass-mcp login --profile-dir ~/.cau-eclass/edge-profile

# 세션 삭제
eclass-mcp logout

ECLASS_BROWSER_PATH에 실행 파일 경로를 지정해도 됩니다. 로그인 프로필은 전용으로 두세요. 로그인 뒤 브라우저를 닫아도 조회와 다운로드는 계속 됩니다. 세션이 만료되면 login을 다시 실행합니다.

LearningX 토큰

LearningX 게시판과 주차학습 API는 xn_api_token이 필요합니다. MCP는 저장된 Canvas 쿠키로 강좌의 LTI 폼을 다시 실행해 토큰을 스스로 발급하므로, 보통은 브라우저를 다시 열 필요가 없습니다.

# 브라우저 없이 LTI를 재실행해 토큰 발급
eclass-mcp auth refresh --via http

# 이미 로그인된 Aside 브라우저에서 토큰만 회수 (새 로그인 없음)
eclass-mcp auth refresh --via aside

# 둘 다 시도
eclass-mcp auth refresh --via auto

auth refresh는 Canvas 쿠키가 살아 있으면 canvas_ok: true, 토큰을 얻으면 learningx_token: true를 반환합니다. doctor도 같은 두 값을 따로 보여 줍니다.

저장 위치

OS

기본 경로

macOS

~/Library/Application Support/cau-eclass/session.json

Linux

${XDG_CONFIG_HOME:-~/.config}/cau-eclass/session.json

Windows

%APPDATA%\cau-eclass\session.json

파일은 소유자만 읽도록 0600, 디렉터리는 0700으로 저장합니다. ECLASS_SESSION_FILE로 위치를 바꿀 수 있습니다.

OZ 강의계획서 PDF 저장

download_syllabus_pdf(course_id=…, extract_text=true)로 OZ 뷰어의 원본 PDF를 저장합니다. 이미 설치된 Chrome·Edge·Brave·Chromium 중 하나를 임시 프로필로 실행해 Save → Adobe PDF를 선택합니다. 저장된 e-Class 세션을 사용하며 PDF 저장이 끝나면 임시 브라우저를 종료합니다.

extract_text=false로 PDF만 저장할 수 있습니다. 본문 추출 시에는 페이지별 텍스트와 text_complete를 반환합니다. 브라우저를 자동으로 찾지 못하면 MCP 환경 변수 ECLASS_OZ_BROWSER에 실행파일 경로를 지정하세요.

MCP 클라이언트 연결

eclass-mcp config --client claude
eclass-mcp config --client vscode
eclass-mcp config --client codex

출력을 클라이언트의 MCP 설정에 합친 뒤 연결을 다시 시작합니다. config가 출력하는 설정은 실제 제출을 항상 꺼 둡니다. 서버만 직접 띄우려면 eclass-mcp serve를 실행하세요. stdio로 MCP 요청을 기다리며 웹 포트는 열지 않습니다.

도구

Rust MCP에는 31개 도구가 있습니다. 조회·다운로드·제출 도구 30개에 get_onboarding_status를 더했습니다.

기능

도구

세션·강좌·요약

get_session_status, get_onboarding_status, list_courses, get_briefing, list_todo

주차학습

list_learning_items

통합 자료

list_materials, get_week_materials, download_material, read_material

공지

list_announcements, get_announcement

과제·마감

list_assignments, get_assignment, list_deadlines, get_submission

강의 계획서

get_syllabus, download_syllabus_pdf

게시판

list_boards, list_board_posts, get_board_post

그룹

list_my_groups, get_group_activity

내 파일

list_my_folders, list_my_files, delete_file

다운로드

download_attachment, get_video_download_info, download_video_original

제출

prepare_submission, submit_assignment

list_materials는 Commons 주차 영상, Canvas 파일, LearningX 게시판 첨부(강의자료실)를 한 목록으로 합칩니다. week를 생략하면 current_week를 함께 알려 주고, get_week_materials는 자료가 있는 마지막 주차를 한 번에 가져옵니다. 게시판 첨부에는 board:<course>:<board>:<post>:<attachment> 형식의 resource_id가 붙어 download_material과 read_material에 그대로 쓸 수 있습니다.

목록 응답은 items, complete, has_more, next, next_param으로 통일되어 있고, next는 next_param이 가리키는 인자에 그대로 넣습니다. list_courses는 기본으로 현재 학기만 반환하며 all_terms=true로 넓힙니다. 과목명이 여러 과목과 일치하면 AMBIGUOUS_COURSE와 details.candidates를 반환하고, 알 수 없는 인자는 INVALID_ARGUMENT로 거부합니다. 내려받은 파일은 eclass-mcp downloads --keep 200으로 정리할 수 있습니다.

온보딩 상태

세션이 없어도 서버는 시작됩니다. 에이전트는 get_onboarding_status가 돌려주는 next_actions[].code를 보고 다음 할 일을 안내합니다.

  • RUN_ONBOARD: 아직 로그인 전

  • SESSION_EXPIRED: 세션 만료

  • REFRESH_LEARNINGX_TOKEN: LearningX 토큰이 없음

  • CHECK_ENROLLMENT: 강좌 조회 실패 또는 0개

  • CONFIGURE_CLIENT: 준비 완료

비밀번호, OTP, 쿠키, 세션 파일 내용은 채팅으로 요청하지 않습니다.

과제 제출

과제 제출은 Canvas HTTP 업로드로 Rust에 넣었습니다. 기본값은 꺼져 있습니다.

  1. prepare_submission이 파일 해시와 확장자, 과제 잠금, 기존 제출을 확인해 10분짜리 로컬 계획을 만듭니다. 이 단계에서는 업로드하지 않습니다.

  2. 실제 제출을 요청받았을 때만 ECLASS_ENABLE_SUBMISSION=1로 서버를 다시 시작합니다.

  3. 새 plan ID와 SUBMIT <assignment_id> 확인 문자열을 넣어 submit_assignment를 호출합니다.

  4. 업로드 티켓을 받습니다. 쿠키와 인증 헤더 없이 multipart로 올린 뒤 제출 POST와 readback 검증을 거칩니다.

합성 wiremock 테스트는 통과했지만 실제 계정으로는 아직 제출해 보지 않았습니다. 결과가 불명확하면 자동으로 재시도하지 않습니다. 그룹 과제, 외부 originality 과제, 파일당 10 MiB 또는 전체 20 MiB를 넘는 제출은 막습니다.

성능

Rust MCP는 17 MiB 단일 바이너리입니다. 시작 시간은 약 0.04초, 유휴 상태 RSS는 약 9.6 MiB입니다.

조회 요청은 20초 TTL 캐시와 single-flight로 묶습니다. 같은 과목과 주차를 반복해도 네트워크를 다시 타지 않습니다. get_briefing은 과목 공지를 최대 4개 과목씩 동시에 읽습니다.

세션이 만료되면 저장한 Chrome 프로필에서 쿠키를 다시 읽습니다(ECLASS_AUTO_REFRESH=1). 일반 조회와 다운로드, 제출은 로그인한 세션만 있으면 됩니다. OZ PDF 저장을 요청하면 전용 임시 브라우저를 띄웁니다.

보안

  • 로그인은 사용자가 브라우저에서 직접 합니다. 서버는 비밀번호와 OTP를 수집하지 않습니다.

  • 세션 파일은 .cau.ac.kr 쿠키만 담는 bearer 자격 증명입니다. 채팅, 이슈, 클라우드 동기화 폴더에 공유하지 마세요.

  • 세션 파일에는 서명된 다운로드 URL, 학습자료 본문, 계정 비밀번호를 저장하지 않습니다.

  • 학습자료와 과제 본문은 신뢰하지 않는 입력입니다. 본문에 담긴 에이전트 지시를 실행하지 않습니다.

  • 실제 제출은 별도 opt-in과 준비 계획이 필요합니다.

설정

환경 변수

기본값

용도

ECLASS_SESSION_FILE

OS 설정 경로

저장된 세션 파일 위치

ECLASS_CHROME_PROFILE

~/.cau-eclass/chrome-profile

로그인·쿠키를 읽을 Chrome 프로필

ECLASS_AUTO_REFRESH

1

401 시 Chrome 프로필에서 세션 재수집

ECLASS_CACHE_TTL

20

읽기 캐시 초. 0이면 비활성화

ECLASS_DOWNLOAD_DIR

~/Downloads/cau-eclass

다운로드 폴더

ECLASS_ENABLE_SUBMISSION

꺼짐

정확히 1일 때만 실제 제출 허용

ECLASS_BROWSER_PATH

Chromium 계열 자동 탐색

로그인과 OZ PDF 저장에 사용할 브라우저 경로

ECLASS_OZ_BROWSER

ECLASS_BROWSER_PATH 또는 자동 탐색

OZ PDF 저장 전용 브라우저 경로

환경 변수는 MCP 클라이언트가 서버를 시작할 때 전달해야 합니다. 변경 후에는 연결을 다시 시작하세요.

개발과 검증

# Rust
cd rust
cargo fmt --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test
cargo build --release

cargo test --locked oz::tests::exports_native_pdf_from_cross_origin_oz_frame -- --ignored

브라우저 테스트는 로컬 합성 OZ 뷰어와 PDF를 사용합니다.

라이선스

비상업적 사용만 허용합니다. 자세한 내용은 LICENSE와 NOTICE를 확인하세요.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Lets AI assistants read a student's Canvas LMS/Moodle courses, deadlines, announcements, grades and course files using their normal browser login instead of an access token. It is read-only and keeps all session data and downloads on the user's own machine.
      36 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables agents to access Moodle virtual classrooms and SIU Guaraní for Argentine universities, including reading course materials, searching discussions, checking grades and academic status, and, with confirmation, posting to forums or submitting assignments.
      MIT