Skip to main content
Glama

ku-portal-mcp

PyPI version Python License: MIT

고려대학교 KUPID 포털 MCP 서버 — Claude Code에서 대학 생활에 필요한 정보를 바로 조회

"공지사항 보여줘", "도서관 빈자리 있어?", "이번 주 과제 뭐 있어?" 같은 자연어로 포털과 LMS를 사용할 수 있습니다.

2026 차세대 포털 전환 대응 (v0.13.0 → v0.17.0)

고려대학교가 2026년 포털·학사·LMS를 차세대 시스템으로 교체하면서 기존 tool 31개 중 28개가 동작을 멈췄습니다. v0.13.0~v0.17.0에 걸쳐 전부 복구했습니다.

무엇이 바뀌었나

영역

이전

이후

포털

*.kpd 경로

index.jsp + SSO (레거시 경로는 301 폐지)

통합 로그인

ksso.korea.ac.kr (*.do)

sso.korea.ac.kr (*.eps) — 비밀번호 AES 암호화 전송

공지·장학

grw.korea.ac.kr HTML 스크래핑

포털 공개 JSON API (/ctt/svc/bulletin)

학사

infodepot.korea.ac.kr

ams.korea.ac.kr + 2차 보안인증 필수

LMS 진입

/exsignon/

/exsignon_new/

학사일정

포털 게시판

교무처 학사일정표

infodepot · grw · ksso 세 도메인은 서비스가 종료되어 TLS 협상조차 되지 않습니다.

무엇이 좋아졌나

  • 공지·학사일정·장학·검색이 로그인 없이 동작합니다. 스크래핑 대신 포털이 쓰는 공개 JSON API로 옮겨, 더 빠르고 조회수·부서·첨부 수 같은 정보도 함께 옵니다.

  • 공지/장학 상세가 본문 전문과 첨부파일(파일명·크기·다운로드 링크)을 반환합니다.

  • LMS 14개 전부 복구. Canvas API는 멀쩡했고 로그인 경로만 바뀐 것이었습니다.

  • 학사 조회는 2차 인증 한 번으로 50분간 유지됩니다. 매 호출마다 인증하지 않습니다.

무엇이 달라져 주의가 필요한가

  • kupid_get_schedules — 파라미터가 page/count → year/semester/month (학사일정이 게시판에서 표 형태로 바뀌었습니다)

  • kupid_get_notice_detail / kupid_get_scholarship_detail — 식별자가 post_seq 하나로

  • kupid_search_courses / kupid_room_schedule — 교과목명 키워드로 검색 (학사 시스템이 단과대/학과 단위 목록 조회를 더 이상 제공하지 않습니다)

  • kupid_get_schedule_detail 제거 — 학사일정에 상세 개념이 사라졌습니다

  • kupid_get_syllabus 제거 → v0.19.0에서 kupid_syllabus로 부활했습니다. 메뉴가 사라진 게 아니라 학사 시스템(AMS)으로 옮겨가 로그인 없이 열려 있었습니다. 수강신청 전 과목이나 남의 과목도 조회됩니다 (kupid_lms_syllabus는 내가 수강 중인 과목만, 개강 이후에만 보입니다)

  • 무인증 게시판 조회는 최신 500건까지입니다 (포털이 그 이후 페이징을 로그인 세션에 묶어두었습니다)

자세한 변경 이력은 CHANGELOG.md를 참고하세요.

Related MCP server: canvas-mcp-server

이런 걸 할 수 있어요

1. 공지사항 / 학사일정 / 장학공지 (로그인 불필요)

KUPID 포털 게시판과 교무처 학사일정을 로그인 없이 조회하고 검색할 수 있습니다.

> 최근 공지사항 보여줘
> "수강신청" 관련 공지 검색해줘
> 이번 학기 학사일정 알려줘
> 9월 학사일정만 보여줘
> 장학금 관련 공지 있어?
  • 공지사항(b=6), 장학공지(b=10) 목록 조회 — 작성자·부서·조회수·첨부 수·요약 포함

  • 학사일정 — 교무처 학사일정표에서 학기별 조회, 월 단위 필터 지원

  • 제목·요약 기준 키워드 통합 검색

  • 게시글 본문 전문과 첨부파일은 포털 로그인 시 제공됩니다 (로그인 없으면 요약 약 200자 + 원문 링크)

  • 무인증 목록 조회는 최신 500건까지 지원합니다 (포털이 그 이후 페이징을 로그인 세션에 묶어둠)

2. 도서관 좌석 현황 (로그인 불필요)

6개 도서관, 53개 열람실의 실시간 좌석 현황을 확인합니다. 로그인 없이 바로 조회 가능합니다.

> 중앙도서관 빈자리 몇 개야?
> 과학도서관 좌석 현황 보여줘
> 전체 도서관 좌석 현황 알려줘
> 노트북 사용 가능한 열람실 어디야?
  • 대상 도서관: 중앙도서관, 중앙광장, 백주년기념 학술정보관, 과학도서관, 하나스퀘어, 법학도서관

  • 열람실별 총 좌석 / 사용 중 / 잔여 좌석 실시간 표시

  • 노트북 허용 여부, 운영시간 정보 포함

  • 전체 도서관 합산 이용률(%) 제공

3. 학사 정보 조회 — 2차 보안인증 한 번이면 됩니다

수강신청내역·시간표·성적·개설과목·강의실은 학사 시스템(AMS) 에 있고, 학교 정책상 2차 보안인증을 거쳐야 합니다. 처음 한 번만 인증하면 약 50분간 세션이 유지되어 그동안은 그냥 물어보면 됩니다.

> 학사 인증 시작해줘          ← 포털에 등록된 메일로 6자리 코드가 옵니다
> 코드 123456                ← 인증 완료, 이후 50분간 자유롭게 조회

추가 설치나 브라우저는 필요 없습니다. 코드는 KUPID 포털에 등록된 이메일로 오며, 따로 등록할 것은 없습니다 (자세한 내용은 설치 > 학사 조회를 쓰려면 참고). 공지·LMS·도서관 등 나머지 기능은 이 인증과 무관합니다.

4. 수업시간표 + ICS 내보내기

> 이번 주 시간표 보여줘
> 월요일 수업 뭐 있어?
> 시간표를 ICS 파일로 만들어줘
  • 월~토 요일별 조회 또는 전체 주간 시간표

  • 교시 → 실제 시간 자동 변환 (1교시=09:00~10:15 … 야간 11교시까지)

  • ICS 캘린더 파일 생성 → 구글/Apple 캘린더에 바로 추가

  • 과목명, 강의실, 교시 포함

5. 내 수강신청 내역

> 내 수강과목 보여줘
> 이번 학기 뭐 듣고 있어?
> 총 몇 학점 신청했어?
  • 학수번호·분반·이수구분·교과목명·담당교수·학점

  • 강의시간/강의실 (예: 월(7-8) 애기능생활관 301호)

  • 신청 상태와 등록금 수납 상태

  • 총 신청 학점 합산

  • 학기를 지정하지 않으면 현재 학기, 지정하면 해당 학기 (year, semester)

6. 전체 성적 / 누적 GPA / 취득학점

> 전체 성적 보여줘
> 누적 GPA 얼마야?
> 2026학년도 1학기 성적만 보여줘
  • 과목별 등급(A+/B+…)과 평점, 이수구분, 학점

  • 누적 GPA · 취득학점 · 총평점 · 환산점수 · 전공학점

  • year_term(예: 20261R)으로 학기 필터링

7. 개설과목 검색 · 강의실 조회

> "자연어처리" 개설과목 검색해줘
> 딥러닝 수업 어느 강의실이야?
> 정보통신관에서 하는 딥러닝 수업 있어?
  • 교과목명 키워드로 검색 → 학수번호·분반·강의실·건물·캠퍼스

  • 건물명·캠퍼스로 결과 필터링

  • ℹ️ 학사 시스템이 제공하는 검색 조건이 교과목명뿐이라, 예전처럼 단과대/학과 단위로 목록을 훑는 방식은 더 이상 지원하지 않습니다.

> BDC108 강의계획서 보여줘
> 이 과목 중간 기말 과제 비중이 어떻게 돼?
> AAI117 주차별 계획 알려줘
  • 강의계획서(kupid_syllabus)는 로그인 없이 조회됩니다 — 평가 비중(중간·기말·과제 %), 주차별 계획, 교재·참고문헌, 절대/상대평가 여부, 담당교수 연락처·면담시간

  • 수강신청 전에, 아직 듣지 않는 과목도 볼 수 있습니다 (kupid_lms_syllabus는 내가 수강 중인 과목만, 개강 이후에만 보입니다)

  • 교수가 아직 계획서를 작성하지 않았으면 note로 알려 줍니다

8. Canvas LMS — 수강과목 / 과제 / 강의자료

고려대학교 Canvas LMS(mylms.korea.ac.kr)에 접속하여 수강 정보를 조회합니다.

> LMS에 어떤 과목 듣고 있어?
> 딥러닝 과제 목록 보여줘
> 아직 안 낸 과제 있어?
> 자연어처리 강의자료 보여줘
> 텍스트마이닝 1주차 PDF 다운로드해줘
> 이번 주 제출할 과제 뭐야?
> LMS 대시보드 보여줘
> 딥러닝 성적 어때?
> 과제 제출 현황 보여줘
> 퀴즈 일정 있어?
  • 수강과목 목록: 현재 학기 수강 중인 과목과 학기 정보

  • 과제 목록: 과목별 과제, 제출 기한, 배점, 제출 방식 확인

  • 강의자료(모듈): 주차별 강의 모듈과 포함된 자료(강의 영상, PDF, 퀴즈 등)

  • 파일 다운로드: 강의자료 PDF 등을 지정한 로컬 디렉토리에 직접 저장

  • 게시판 조회: Q&A 게시판 / 강의자료실 등 교수님이 직접 올리는 자료까지 탐색

  • 할 일 목록: 마감이 다가오는 과제와 이벤트를 한눈에

  • 대시보드: 수강 과목 카드 + 과목별 공지사항 모아보기

  • 성적/점수 조회: 과목별 현재 점수, 최종 점수, 학점 확인

  • 과제 제출 현황: 제출 여부, 채점 점수, 지각/미제출 상태 확인

  • 퀴즈/시험 목록: 퀴즈 일정, 시간제한, 문항 수 확인

더 많은 사용 예시는 EXAMPLES.md를 참고하세요.


전체 Tool 목록

#

Tool

설명

인증

1

kupid_login

포털 로그인 / 세션 확인

SSO

2

kupid_get_notices

공지사항 목록

불필요

3

kupid_get_notice_detail

공지사항 상세 (로그인 시 본문 전문 + 첨부)

선택

4

kupid_get_schedules

학사일정 (학기별, 월 필터)

불필요

5

kupid_get_scholarships

장학공지 목록

불필요

6

kupid_get_scholarship_detail

장학공지 상세 (로그인 시 본문 전문 + 첨부)

선택

7

kupid_search

공지/장학 통합 검색

불필요

8

kupid_get_library_seats

도서관 열람실 좌석 현황

불필요

9

kupid_ams_auth_start

학사(AMS) 2차 인증 시작 — 메일로 코드 발송

SSO

10

kupid_ams_auth_verify

학사(AMS) 2차 인증 완료 (6자리 코드)

SSO

11

kupid_my_courses

내 수강신청 내역 (학수번호/시간/강의실)

AMS 2차

12

kupid_get_timetable

개인 수업시간표 + ICS 내보내기

AMS 2차

13

kupid_get_all_grades

전체 성적 / 누적 GPA / 취득학점

AMS 2차

14

kupid_search_courses

개설과목 검색 (교과목명)

AMS 2차

15

kupid_room_schedule

교과목의 강의실·건물 조회

AMS 2차

16

kupid_lms_courses

LMS 수강과목 목록

SSO

17

kupid_lms_assignments

LMS 과제 목록 (과목별)

SSO

18

kupid_lms_modules

LMS 강의자료 (주차별 모듈)

SSO

19

kupid_lms_todo

LMS 할 일 / 다가오는 이벤트

SSO

20

kupid_lms_dashboard

LMS 대시보드 + 공지사항

SSO

21

kupid_lms_grades

LMS 성적/점수 조회

SSO

22

kupid_lms_submissions

LMS 과제 제출 현황

SSO

23

kupid_lms_quizzes

LMS 퀴즈/시험 목록

SSO

24

kupid_lms_download_file

LMS 강의자료 파일 다운로드 (PDF 등)

SSO

25

kupid_lms_list_boards

LMS 과목 게시판 목록 (Q&A, 강의자료실 등)

SSO

26

kupid_lms_list_board_posts

게시판 게시글 목록

SSO

27

kupid_lms_get_board_post

게시글 상세 + 첨부파일 + 댓글(첨부 포함)

SSO

28

kupid_lms_announcements

LMS 공지 전문 조회 (과목별 또는 전체, 본문 비절단)

SSO

29

kupid_lms_syllabus

LMS 강의계획서 조회

SSO

30

kupid_dept_notices

학과/대학원 홈페이지 공지 목록

불필요

31

kupid_dept_notice_detail

학과/대학원 공지 상세

불필요

32

kupid_syllabus

강의계획서 — 평가 비중·주차별 계획·교재·교수 연락처

불필요

33

kupid_lms_submit_assignment

LMS 파일 업로드형 과제 제출 (기본 미리보기, confirm=True일 때만 실제 제출)

SSO

인증 안내: SSO = 고려대 통합 로그인(sso.korea.ac.kr). 포털과 LMS 모두 같은 ID/PW를 사용하며, 환경변수만 설정하면 자동으로 로그인됩니다.

선택 = 로그인 없이도 동작하지만, 로그인하면 더 많은 정보를 반환합니다.

AMS 2차 = 학사 시스템은 학교 정책상 2차 보안인증이 필수입니다. kupid_ams_auth_start() → 포털에 등록된 메일로 온 6자리 코드로 kupid_ams_auth_verify(code) 하면 약 50분간 세션이 유지되며, 그동안은 재인증 없이 조회됩니다. v0.18.0부터 별도 설치 없이 동작합니다.

설치

방법 1: uvx (권장)

설치 없이 항상 최신 버전을 실행합니다. Claude Code와의 호환성이 가장 좋습니다.

uvx ku-portal-mcp

방법 2: pip

pip install ku-portal-mcp

방법 3: 소스에서 설치

git clone https://github.com/SonAIengine/ku-portal-mcp.git
cd ku-portal-mcp
pip install -e .

학사 조회를 쓰려면

수강신청내역·시간표·성적·개설과목·강의실은 학사 시스템의 2차 보안인증을 통과해야 합니다. 추가 설치는 필요 없습니다. 위 설치만으로 32개 tool 전부가 동작합니다.

> 학사 인증 시작해줘          ← 메일로 6자리 코드가 옵니다
> 코드 123456                ← 인증 완료, 이후 50분간 자유롭게 조회

v0.17.x까지는 이 인증에 playwright와 Chromium(수백 MB) 설치가 필요했지만, v0.18.0에서 순수 HTTP로 재구현해 의존성을 없앴습니다.

인증 코드는 어디로 오나요

KUPID 포털에 등록된 이메일 주소로 옵니다. 따로 등록할 것은 없습니다 — 포털 가입 때 넣은 주소가 그대로 쓰입니다.

궁금한 것

답

주소를 바꾸려면

포털 > My Page > 개인정보 수정

MCP에 이메일을 등록하나요

아니요. 환경변수는 KU_PORTAL_ID / KU_PORTAL_PW 둘뿐입니다

메일이 안 와요

스팸함을 확인하세요. 학교 안내에도 명시된 흔한 경우입니다

코드 유효시간

5분. 지나면 인증을 다시 시작하면 됩니다

이 MCP는 메일을 보내지 않습니다. 학교 SSO 서버에 "발송해 달라"고 요청할 뿐이고(요청 바디에 주소를 싣지 않습니다), 서버가 세션으로 사용자를 식별해 등록된 주소로 직접 보냅니다. 응답으로는 마스킹된 형태(son****@gmail.com)만 돌아옵니다. 따라서 이 도구가 임의의 주소로 코드를 보내는 것은 구조적으로 불가능하며, 코드는 언제나 계정 주인의 메일함으로만 갑니다.

업데이트

학교가 시스템을 바꾸면 tool이 동작을 멈출 수 있습니다. 그럴 때 최신 버전으로 올리세요.

uvx로 쓰는 경우

uvx는 캐시된 버전을 재사용하기 때문에 그냥 재시작해도 옛 버전이 뜹니다. 캐시를 지우고 다시 받아야 합니다.

uv cache clean ku-portal-mcp

이후 Claude Code를 재시작하면 최신 버전이 설치됩니다. 특정 버전을 고정하려면 MCP 설정의 args에 ku-portal-mcp@0.17.0 처럼 적으면 됩니다.

pip으로 쓰는 경우

pip install --upgrade ku-portal-mcp

소스로 쓰는 경우

cd ku-portal-mcp
git pull
pip install -e .

업데이트 후 확인

Claude Code를 반드시 재시작해야 새 버전이 적용됩니다 (MCP 서버는 시작 시 한 번 로드됩니다).

claude mcp list          # 연결 상태 확인
uvx ku-portal-mcp --version

Claude Code 안에서는 이렇게 확인할 수 있습니다.

> 공지사항 3개만 보여줘        ← 무인증 기능이 되는지
> 학사 인증 시작해줘           ← 학사 기능이 되는지

환경변수를 바꿨을 때도 재시작이 필요합니다. MCP 서버는 시작 시점의 환경변수를 읽습니다. ~/.zshrc에서 비밀번호를 설정한다면 작은따옴표를 쓰세요 — 큰따옴표 안의 \! 같은 이스케이프는 백슬래시가 값에 그대로 남아 로그인이 실패합니다.

export KU_PORTAL_PW='p@ssw0rd!'   # O
export KU_PORTAL_PW="p@ssw0rd\!"  # X — 값이 `p@ssw0rd\!` 가 됩니다

Claude Code에서 사용하기

1. MCP 서버 등록

claude mcp add CLI 명령으로 등록합니다:

uvx 사용 (권장):

claude mcp add -s user \
  -e KU_PORTAL_ID=your-kupid-id \
  -e KU_PORTAL_PW=your-kupid-password \
  ku-portal \
  uvx ku-portal-mcp@latest

pip으로 설치한 경우:

claude mcp add -s user \
  -e KU_PORTAL_ID=your-kupid-id \
  -e KU_PORTAL_PW=your-kupid-password \
  ku-portal \
  ku-portal-mcp
  • KU_PORTAL_ID와 KU_PORTAL_PW는 KUPID 포털 로그인에 사용하는 학번과 비밀번호입니다.

  • -s user는 글로벌(모든 프로젝트) 등록입니다. 특정 프로젝트에서만 사용하려면 -s project로 변경하세요.

2. 설정 적용

MCP 서버 설정은 Claude Code 시작 시점에 1회 로드됩니다.

  • 방법 A: Claude Code를 재시작

  • 방법 B: 세션 내에서 /mcp 명령어 실행 → MCP 서버 추가/재시작을 재시작 없이 바로 적용

3. 동작 확인

Claude Code에서 아래와 같이 자연어로 물어보세요:

> 도서관 좌석 현황 보여줘

로그인 없이 바로 결과가 나오면 정상적으로 설치된 것입니다.

> 최근 공지사항 보여줘
> 이번 주 과제 뭐 있어?
> 내 시간표 보여줘

4. /ku 슬래시 커맨드 활용

examples/commands/ku.md를 Claude Code의 커스텀 슬래시 커맨드로 등록하면, /ku 한 줄로 포털 조회를 더 빠르게 할 수 있습니다.

설치: examples/commands/ku.md 파일을 프로젝트의 .claude/commands/ 또는 ~/.claude/commands/에 복사합니다.

# 글로벌 커맨드로 등록 (모든 프로젝트에서 사용)
mkdir -p ~/.claude/commands
cp examples/commands/ku.md ~/.claude/commands/ku.md

사용 예시:

> /ku 도서관
> /ku 공지 수강신청
> /ku 과제
> /ku 시간표
> /ku 성적
> /ku 검색 장학금

슬래시 커맨드는 필요한 MCP tool만 자동으로 허용하므로, 자연어 질의보다 빠르고 정확하게 동작합니다. 자세한 키워드 목록은 examples/commands/ku.md를 참고하세요.

프로젝트 구조

ku_portal_mcp/
├── server.py       # MCP 서버 + 32개 tool 등록
├── sso.py          # 고려대 통합 로그인 (sso.korea.ac.kr) — 비밀번호 AES 암호화
├── auth.py         # 포털 세션 확립, 세션 캐싱 (30분 TTL)
├── portal_api.py   # 포털 게시판 JSON API + 교무처 학사일정 (무인증)
├── ams.py          # 학사 시스템 (ams.korea.ac.kr) 조회 API
├── _ams_auth.py    # 학사 2차 보안인증 헬퍼 (브라우저 자동화, 선택 의존성)
├── _storage.py     # 세션 캐시 보안 저장 (0600, atomic write)
├── library.py      # 도서관 좌석 현황 (librsv.korea.ac.kr)
├── timetable.py    # 교시↔시간 변환 + ICS export
├── dept_notices.py # 학과/대학원 홈페이지 공지
└── lms.py          # Canvas LMS 연동 (mylms.korea.ac.kr)

기술 스택

영역

기술

설명

MCP

FastMCP (mcp[cli])

Claude Code 연동 프로토콜

HTTP

httpx (async)

비동기 HTTP 클라이언트

파싱

BeautifulSoup4 + lxml

HTML 스크래핑

통합 인증

sso.korea.ac.kr

AES-128-CBC 비밀번호 암호화 + 자동 제출 폼 체인 추적

학사 인증

IOP 2차 보안인증

이메일 OTP, 브라우저 컨텍스트 검증

LMS 인증

Canvas 인계

RSA 복호화한 임시 비밀번호 + Rails CSRF

암호화

cryptography

AES(로그인) / RSA(Canvas)

공지·장학

포털 JSON API

/ctt/svc/bulletin (인증 불필요)

학사 조회

AMS DataSet API

넥사크로 규약 (@d1#<필드>)

도서관

HODI REST API

librsv.korea.ac.kr (인증 불필요)

LMS API

Canvas REST API

mylms.korea.ac.kr 세션 쿠키 인증

브라우저

Playwright (선택)

학사 2차 인증 전용

트러블슈팅

MCP 서버가 연결되지 않을 때

  1. 서버가 정상 동작하는지 확인:

    ku-portal-mcp --version
  2. 서버가 등록되어 있는지 확인:

    claude mcp list

    목록에 ku-portal이 없으면 설치 > 1. MCP 서버 등록을 참고하세요.

  3. Claude Code 재시작 후 /mcp 명령으로 서버 상태 확인

MCP 서버가 목록에 보이지 않을 때

Claude Code는 MCP 서버 설정을 ~/.claude.json에서 읽습니다. ~/.claude/settings.json의 mcpServers에 넣으면 인식되지 않습니다.

반드시 claude mcp add 명령으로 등록하세요:

claude mcp add -s user \
  -e KU_PORTAL_ID=your-id \
  -e KU_PORTAL_PW=your-pw \
  ku-portal \
  uvx ku-portal-mcp@latest

서버 시작 시 타임아웃이 발생할 때

서버 초기화에 수 초가 걸릴 수 있습니다. 기본 타임아웃이 짧아 연결 실패가 발생하면, ~/.claude/settings.json의 env에 타임아웃을 늘려주세요:

{
  "env": {
    "MCP_TIMEOUT": "30000"
  }
}

환경변수 관련

  • claude mcp add 시 -e 옵션으로 환경변수를 설정합니다

  • 이미 등록된 서버의 환경변수를 변경하려면 claude mcp remove ku-portal 후 다시 추가하세요

라이선스

MIT

Available Tools

31 tools
kupid_dept_notice_detailA

학과/대학원 공지사항의 상세 내용을 조회합니다 (인증 불필요).

kupid_dept_notices로 조회한 공지의 상세 내용을 가져옵니다.

Args: site_name: 사이트 이름 또는 키 (kupid_dept_notices에서 사용한 값) article_no: 게시글 번호 (kupid_dept_notices 결과의 article_no 필드)

Inputs: site_name (required), article_no (required). Returns: object

kupid_dept_noticesA

학과/대학원 홈페이지 공지사항을 조회합니다 (인증 불필요).

고려대학교 학과 홈페이지의 공지사항 게시판을 스크래핑합니다. site_name을 지정하지 않으면 사용 가능한 사이트 목록을 반환합니다.

환경변수 KU_DEPT_URLS로 소속 학과를 설정할 수 있습니다. 형식: "라벨|URL,라벨|URL,..." 예: "SW·AI융합대학원|https://gscit.korea.ac.kr/gscit/board/notice_master.do"

Args: site_name: 사이트 이름 또는 키 (빈 문자열이면 사이트 목록 반환) page: 페이지 번호 (기본값: 1) count: 한 페이지당 항목 수 (기본값: 20)

Inputs: site_name, page, count. Returns: object

kupid_get_all_gradesA

전체 성적, 누적 GPA, 취득학점을 조회합니다 (SSO 로그인 필요).

KUPID 학적/졸업 > 성적사항 > 전체성적조회 화면의 최종 확정 성적을 가져옵니다.

Args: year_term: 조회할 학년도/학기 코드 (예: "20242R"). 비우면 전체 조회

Inputs: year_term. Returns: object

kupid_get_library_seatsA

고려대학교 도서관 열람실 좌석 현황을 조회합니다.

인증 없이 실시간 좌석 현황을 확인할 수 있습니다.

Args: library_name: 도서관 이름 필터 (빈 문자열이면 전체 도서관 조회) - 중앙도서관, 중앙광장, 백주년기념 학술정보관, 과학도서관, 하나스퀘어, 법학도서관

Inputs: library_name. Returns: object

kupid_get_notice_detailA

KUPID 공지사항의 상세 내용을 조회합니다.

Args: notice_id: 공지사항 index (kupid_get_notices 결과의 index 필드) message_id: 공지사항 message_id (kupid_get_notices 결과의 message_id 필드)

Inputs: notice_id (required), message_id. Returns: object

kupid_get_noticesC

KUPID 포털의 공지사항 목록을 조회합니다.

Args: page: 페이지 번호 (기본값: 1) count: 한 페이지당 항목 수 (기본값: 20)

Inputs: page, count. Returns: object

kupid_get_schedule_detailB

KUPID 학사일정의 상세 내용을 조회합니다.

Args: schedule_id: 학사일정 index (kupid_get_schedules 결과의 index 필드) message_id: 학사일정 message_id (kupid_get_schedules 결과의 message_id 필드)

Inputs: schedule_id (required), message_id. Returns: object

kupid_get_schedulesA

KUPID 포털의 학사일정 목록을 조회합니다.

Args: page: 페이지 번호 (기본값: 1) count: 한 페이지당 항목 수 (기본값: 20)

Inputs: page, count. Returns: object

kupid_get_scholarship_detailA

KUPID 장학공지의 상세 내용을 조회합니다.

Args: scholarship_id: 장학공지 index (kupid_get_scholarships 결과의 index 필드) message_id: 장학공지 message_id (kupid_get_scholarships 결과의 message_id 필드)

Inputs: scholarship_id (required), message_id. Returns: object

kupid_get_scholarshipsC

KUPID 포털의 장학공지 목록을 조회합니다.

Args: page: 페이지 번호 (기본값: 1) count: 한 페이지당 항목 수 (기본값: 20)

Inputs: page, count. Returns: object

kupid_get_syllabusA

강의계획서를 조회합니다 (SSO 로그인 필요).

Args: course_code: 학수번호 (예: "COSE101") section: 분반 (예: "02") year: 학년도 (기본값: 현재 학기 기준 자동 선택) semester: 학기 ("1"=1학기, "2"=2학기, "summer"=여름학기, "winter"=겨울학기)

Inputs: course_code (required), section, year, semester. Returns: object

kupid_get_timetableA

개인 수업시간표를 조회합니다 (SSO 로그인 필요).

포털 메인 페이지의 시간표 위젯 데이터를 파싱합니다.

Args: day: 요일 ("all"=전체, "mon"/"tue"/"wed"/"thu"/"fri") ics_export: True이면 ICS 캘린더 파일 내용도 포함

Inputs: day, ics_export. Returns: object

kupid_lms_announcementsA

Canvas LMS 공지(announcement)를 조회합니다.

course_id를 지정하면 해당 과목, 생략하면 현재 활성 과목 전체의 공지를 가져옵니다. kupid_lms_dashboard와 달리 message 본문을 절단하지 않고 전문(HTML)으로 반환합니다.

Args: course_id: 과목 ID (생략 시 활성 과목 전체, kupid_lms_courses 참조)

Inputs: course_id. Returns: object

kupid_lms_assignmentsA

Canvas LMS 과제 목록을 조회합니다.

특정 과목의 전체 과제(assignments) 목록을 가져옵니다. 기본적으로 완료/마감 과제 포함 전체를 반환합니다. kupid_lms_courses로 course_id를 먼저 확인하세요.

Args: course_id: 과목 ID (kupid_lms_courses의 id 필드) upcoming_only: True이면 마감 전 과제만 표시 (기본값: False, 전체 과제 반환)

Inputs: course_id (required), upcoming_only. Returns: object

kupid_lms_coursesB

Canvas LMS 수강과목 목록을 조회합니다.

mylms.korea.ac.kr의 Canvas LMS에서 수강 중인 과목 목록을 가져옵니다. SSO 로그인이 필요합니다.

Inputs: no named parameters. Returns: object

kupid_lms_dashboardA

Canvas LMS 대시보드를 조회합니다.

현재 수강 중인 과목 카드와 과제/이벤트 현황을 보여줍니다.

Inputs: no named parameters. Returns: object

kupid_lms_download_fileA

Canvas LMS 파일을 지정한 디렉토리에 다운로드합니다.

file_id는 kupid_lms_modules 결과의 items에서 type이 'File'인 항목의 content_id 필드에서 얻을 수 있습니다.

Args: file_id: Canvas 파일 ID (items[*].content_id) save_dir: 저장할 디렉토리 절대경로 (예: /Users/me/Documents/lecture) filename: 저장 파일명 (생략 시 Canvas 원본 파일명 사용)

Inputs: file_id (required), save_dir (required), filename. Returns: object

kupid_lms_get_board_postA

게시글 상세와 첨부파일, 댓글(첨부 포함)을 조회합니다.

attachments의 canvas_file_id를 kupid_lms_download_file의 file_id로 넘기면 파일을 다운로드할 수 있습니다. attachments[].url은 직접 다운로드 링크입니다(시간제한 verifier 토큰 포함).

comments에는 각 댓글의 본문과 첨부파일(동영상/PDF 등)이 포함됩니다. 예: 텀프로젝트 게시판에서 팀별 발표 동영상은 댓글 첨부로 제출됩니다.

Args: course_id: 과목 ID board_id: 게시판 ID post_id: 게시글 ID (kupid_lms_list_board_posts의 id 필드)

Inputs: course_id (required), board_id (required), post_id (required). Returns: object

kupid_lms_gradesA

Canvas LMS 성적/점수를 조회합니다.

과목별 현재 점수, 최종 점수, 학점(grade)을 확인합니다. kupid_lms_courses로 course_id를 먼저 확인하세요.

Args: course_id: 과목 ID (kupid_lms_courses의 id 필드)

Inputs: course_id (required). Returns: object

kupid_lms_list_board_postsB

게시판의 게시글 목록을 조회합니다.

Args: course_id: 과목 ID board_id: 게시판 ID (kupid_lms_list_boards의 id 필드) page: 페이지 번호 (기본 1) keyword: 제목 검색어 (기본 전체)

Inputs: course_id (required), board_id (required), page, keyword. Returns: object

kupid_lms_list_boardsA

Canvas LMS 과목의 게시판 목록을 조회합니다.

Q&A 게시판, 강의자료실 등 교수님이 자료를 올리는 게시판들을 반환합니다. Canvas 네이티브 모듈(kupid_lms_modules)에 자료가 없으면 여기서 찾아보세요.

Args: course_id: 과목 ID (kupid_lms_courses의 id 필드)

Inputs: course_id (required). Returns: object

kupid_lms_modulesA

Canvas LMS 강의자료(모듈)를 조회합니다.

주차별 강의 모듈과 포함된 자료를 가져옵니다. kupid_lms_courses로 course_id를 먼저 확인하세요.

Args: course_id: 과목 ID (kupid_lms_courses의 id 필드)

Inputs: course_id (required). Returns: object

kupid_lms_quizzesA

Canvas LMS 퀴즈/시험 목록을 조회합니다.

과목의 퀴즈, 시험, 설문 목록과 마감일, 시간제한 등을 확인합니다. kupid_lms_courses로 course_id를 먼저 확인하세요.

Args: course_id: 과목 ID (kupid_lms_courses의 id 필드)

Inputs: course_id (required). Returns: object

kupid_lms_submissionsA

Canvas LMS 과제 제출 현황을 조회합니다.

과목의 전체 과제에 대한 제출 여부, 점수, 채점 상태를 확인합니다. kupid_lms_courses로 course_id를 먼저 확인하세요.

Args: course_id: 과목 ID (kupid_lms_courses의 id 필드)

Inputs: course_id (required). Returns: object

kupid_lms_syllabusA

Canvas LMS 수업 계획서(syllabus)를 조회합니다.

과목의 수업 계획서 내용을 가져옵니다. course_code(예: BDC115) 또는 course_id 중 하나를 입력하세요. course_code를 입력하면 수강과목 목록에서 자동으로 course_id를 찾습니다.

Args: course_code: 과목코드 (예: BDC115). course_id 대신 사용 가능 course_id: 과목 ID (kupid_lms_courses의 id 필드). course_code 대신 사용 가능

Inputs: course_code, course_id. Returns: object

kupid_lms_todoA

Canvas LMS 할 일(Todo) 목록을 조회합니다.

마감이 다가오는 과제, 퀴즈 등을 보여줍니다.

Inputs: no named parameters. Returns: object

kupid_loginA

KUPID 포털에 로그인하고 세션을 확인합니다.

환경변수 KU_PORTAL_ID, KU_PORTAL_PW가 설정되어 있어야 합니다. 세션이 유효하면 캐시된 세션을 재사용합니다.

Inputs: no named parameters. Returns: object

kupid_my_coursesA

내 수강신청 내역을 조회합니다 (SSO 로그인 필요).

학수번호, 강의시간, 강의실, 교수, 학점, 이수구분 등 상세 정보를 반환합니다. 대학원 과목도 포함됩니다.

Args: year: 학년도 (기본값: 현재 학기 기준 자동 선택) semester: 학기 ("1"=1학기, "2"=2학기, "summer"=여름학기, "winter"=겨울학기)

Inputs: year, semester. Returns: object

kupid_room_scheduleA

건물/강의실의 정규 수업 시간표를 조회합니다 (학부+대학원 통합, SSO 로그인 필요).

"이 강의실 오늘 비어있나?" 확인용. 학부 22개 + 대학원 38개 단과대를 병렬 호출하므로 호출당 30~60초 소요 (총 800+ 학과 fan-out). 같은 학기는 자주 안 바뀌니 결과를 호출 측에서 캐싱 권장.

한계:

  • 학사 시스템에 등록된 정규 수업만 잡힘

  • 학회·세미나·임시 행사 등 비정규 점유는 별도 (spacek.korea.ac.kr 시스템 영역)

Args: building: 건물명 부분일치 (예: "애기능" → "애기능생활관" 매치) room: 호실 부분일치 (예: "301" → "301호" / "B301"). 비우면 건물 전체. day: 요일 필터 ("월"/"화"/.../"토"/"일"). 비우면 전 요일. year: 학년도 (기본값: 현재 학기 기준 자동) semester: 학기 ("1","2","summer","winter") campus: "1"=서울, "2"=세종 include_grad: True(기본)면 대학원도 검색, False면 학부만

Inputs: building (required), room, day, year, +3 more. Returns: object

kupid_search_coursesA

개설과목을 검색합니다 (SSO 로그인 필요).

학과/단과대별로 개설된 과목을 조회합니다. 단과대 코드가 비어있으면 사용 가능한 단과대 목록을 반환합니다.

Args: year: 학년도 (기본값: 현재 학기 기준 자동 선택) semester: 학기 ("1"=1학기, "2"=2학기, "summer"=여름학기, "winter"=겨울학기) college: 단과대/대학원 코드 (예: 학부 "5720"=정보대학, 대학원 "7298"=SW·AI융합대학원) department: 학과 코드 (예: 학부 "5722"=컴퓨터학과, 대학원 "7313"=인공지능융합학과) campus: 캠퍼스 ("1"=서울, "2"=세종) is_grad: True면 대학원(LecGradMajorSub.jsp), False면 학부(LecMajorSub.jsp)

Inputs: year, semester, college, department, +2 more. Returns: object

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 31 tools

    Disambiguation5/5

    Each tool targets a distinct resource or operation. Notices, grades, timetable, library, LMS functions, etc., are cleanly separated with clear descriptions, making it easy for an agent to select the correct tool.

    Naming Consistency3/5

    All tools share the 'kupid_' prefix, but beyond that, naming patterns vary: some use verb_noun (get_notices), some use area_noun (lms_announcements), and some use noun_noun (dept_notices). This inconsistency, while still readable, could confuse an agent.

    Tool Count4/5

    With 31 tools, the server is fairly comprehensive for a university portal. The count is slightly above the ideal range but justified by the breadth of functionality (portal, LMS, search, etc.).

    Completeness5/5

    The tool set covers nearly all expected operations for a university portal: viewing notices, schedules, scholarships, grades, timetable, library seats, and full LMS integration including courses, assignments, quizzes, submissions, boards, and file downloads. No obvious gaps for the read-only nature of the domain.

    Maintenance

    ActivitySlowing
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Read-only MCP server that lets Jeonbuk National University students query their LMS in natural language, covering daily briefings, deadlines, announcements, assignments, and course materials while keeping credentials local.
      25
      27 npm
      MIT
    • A
      license
      A
      quality
      A
      maintenance
      Enables AI assistants to query SeoulTech e-Class course announcements and assignments, search full notice text, track pending work, and refresh login sessions securely through natural language.
      7
      1
      MIT