CAU e-Class MCP
Supports Canvas attachments and Canvas general file assignments, including downloading attachments by Canvas file ID and preparing or submitting supported assignments through the CAU e-Class server.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
CAU e-Class MCP
중앙대학교 e-Class를 MCP 클라이언트에서 다루는 Rust 서버입니다.
e-Class 로그인은 브라우저에서 한 번만 합니다. 강좌, 공지, 과제, 자료 조회와 다운로드, 과제 제출은 HTTP로 처리합니다. OZ 강의계획서 PDF 저장을 포함한 모든 MCP 도구를 Rust 실행파일 하나로 제공합니다.

구조
구성 | 역할 |
Rust | MCP stdio 서버, 31개 도구, HTTP 조회·다운로드·OZ PDF 저장·PDF 텍스트·과제 제출 |
|
|
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 | bashWindows 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 claudedoctor는 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 logoutECLASS_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 autoauth refresh는 Canvas 쿠키가 살아 있으면 canvas_ok: true, 토큰을 얻으면 learningx_token: true를 반환합니다. doctor도 같은 두 값을 따로 보여 줍니다.
저장 위치
OS | 기본 경로 |
macOS |
|
Linux |
|
Windows |
|
파일은 소유자만 읽도록 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를 더했습니다.
기능 | 도구 |
세션·강좌·요약 |
|
주차학습 |
|
통합 자료 |
|
공지 |
|
과제·마감 |
|
강의 계획서 |
|
게시판 |
|
그룹 |
|
내 파일 |
|
다운로드 |
|
제출 |
|
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에 넣었습니다. 기본값은 꺼져 있습니다.
prepare_submission이 파일 해시와 확장자, 과제 잠금, 기존 제출을 확인해 10분짜리 로컬 계획을 만듭니다. 이 단계에서는 업로드하지 않습니다.실제 제출을 요청받았을 때만
ECLASS_ENABLE_SUBMISSION=1로 서버를 다시 시작합니다.새 plan ID와
SUBMIT <assignment_id>확인 문자열을 넣어submit_assignment를 호출합니다.업로드 티켓을 받습니다. 쿠키와 인증 헤더 없이 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과 준비 계획이 필요합니다.
설정
환경 변수 | 기본값 | 용도 |
| OS 설정 경로 | 저장된 세션 파일 위치 |
|
| 로그인·쿠키를 읽을 Chrome 프로필 |
|
| 401 시 Chrome 프로필에서 세션 재수집 |
|
| 읽기 캐시 초. |
|
| 다운로드 폴더 |
| 꺼짐 | 정확히 |
| Chromium 계열 자동 탐색 | 로그인과 OZ PDF 저장에 사용할 브라우저 경로 |
|
| 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를 사용합니다.
라이선스
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Hosted browser for agents: open pages, search the web, extract data, read PDFs and take screenshots.
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
Give your agent eyes: screenshots of any web page it can see, pages as markdown, and PDFs.
61Turn any recording or document into notes, flashcards and quizzes your agent can read and act on
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with Canvas LMS and Gradescope, allowing users to query courses, assignments, modules, calendar events, and find relevant resources using natural language.ISC
- AlicenseNot gradedqualityCmaintenanceLets 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 npm1MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to access and manage academic course information, assignments, submissions, grades, calendars, materials, recordings, and announcements through authenticated LMS sessions.MIT