ku-portal-mcp
ku-portal-mcp is an MCP server that lets you query Korea University's KUPID portal, Canvas LMS, library seats, and academic systems in natural language via Claude Code.
Portal boards: list/search notices, scholarships, and academic schedules; fetch details (full text/attachments with login).
Library seats: check real-time seat availability for 6 libraries / 53 reading rooms without login.
Academic records: after SSO + AMS email 2FA, view your courses, timetable (with ICS export), grades/GPA, course search, room schedules, and syllabus.
Canvas LMS: list courses, assignments, modules, todo, dashboard, announcements, grades, submissions, quizzes, syllabus; download files; read boards/posts/comments.
Department notices: list and read department/graduate homepage notices.
Auth: SSO login for portal/LMS; AMS 2-step email code for academic data.
Provides tools to interact with Canvas LMS, enabling AI agents to retrieve courses, assignments, modules, grades, quizzes, and download course files.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ku-portal-mcp Show me this week's timetable"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ku-portal-mcp
고려대학교 KUPID 포털 MCP 서버 — Claude Code에서 대학 생활에 필요한 정보를 바로 조회
"공지사항 보여줘", "도서관 빈자리 있어?", "이번 주 과제 뭐 있어?" 같은 자연어로 포털과 LMS를 사용할 수 있습니다.
2026 차세대 포털 전환 대응 (v0.13.0 → v0.17.0)
고려대학교가 2026년 포털·학사·LMS를 차세대 시스템으로 교체하면서 기존 tool 31개 중 28개가 동작을 멈췄습니다. v0.13.0~v0.17.0에 걸쳐 전부 복구했습니다.
무엇이 바뀌었나
영역 | 이전 | 이후 |
포털 |
|
|
통합 로그인 |
|
|
공지·장학 |
| 포털 공개 JSON API ( |
학사 |
|
|
LMS 진입 |
|
|
학사일정 | 포털 게시판 | 교무처 학사일정표 |
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 |
| 포털 로그인 / 세션 확인 | SSO |
2 |
| 공지사항 목록 | 불필요 |
3 |
| 공지사항 상세 (로그인 시 본문 전문 + 첨부) | 선택 |
4 |
| 학사일정 (학기별, 월 필터) | 불필요 |
5 |
| 장학공지 목록 | 불필요 |
6 |
| 장학공지 상세 (로그인 시 본문 전문 + 첨부) | 선택 |
7 |
| 공지/장학 통합 검색 | 불필요 |
8 |
| 도서관 열람실 좌석 현황 | 불필요 |
9 |
| 학사(AMS) 2차 인증 시작 — 메일로 코드 발송 | SSO |
10 |
| 학사(AMS) 2차 인증 완료 (6자리 코드) | SSO |
11 |
| 내 수강신청 내역 (학수번호/시간/강의실) | AMS 2차 |
12 |
| 개인 수업시간표 + ICS 내보내기 | AMS 2차 |
13 |
| 전체 성적 / 누적 GPA / 취득학점 | AMS 2차 |
14 |
| 개설과목 검색 (교과목명) | AMS 2차 |
15 |
| 교과목의 강의실·건물 조회 | AMS 2차 |
16 |
| LMS 수강과목 목록 | SSO |
17 |
| LMS 과제 목록 (과목별) | SSO |
18 |
| LMS 강의자료 (주차별 모듈) | SSO |
19 |
| LMS 할 일 / 다가오는 이벤트 | SSO |
20 |
| LMS 대시보드 + 공지사항 | SSO |
21 |
| LMS 성적/점수 조회 | SSO |
22 |
| LMS 과제 제출 현황 | SSO |
23 |
| LMS 퀴즈/시험 목록 | SSO |
24 |
| LMS 강의자료 파일 다운로드 (PDF 등) | SSO |
25 |
| LMS 과목 게시판 목록 (Q&A, 강의자료실 등) | SSO |
26 |
| 게시판 게시글 목록 | SSO |
27 |
| 게시글 상세 + 첨부파일 + 댓글(첨부 포함) | SSO |
28 |
| LMS 공지 전문 조회 (과목별 또는 전체, 본문 비절단) | SSO |
29 |
| LMS 강의계획서 조회 | SSO |
30 |
| 학과/대학원 홈페이지 공지 목록 | 불필요 |
31 |
| 학과/대학원 공지 상세 | 불필요 |
32 |
| 강의계획서 — 평가 비중·주차별 계획·교재·교수 연락처 | 불필요 |
33 |
| LMS 파일 업로드형 과제 제출 (기본 미리보기, | 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에 이메일을 등록하나요 | 아니요. 환경변수는 |
메일이 안 와요 | 스팸함을 확인하세요. 학교 안내에도 명시된 흔한 경우입니다 |
코드 유효시간 | 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 --versionClaude 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@latestpip으로 설치한 경우:
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 |
|
학사 조회 | AMS DataSet API | 넥사크로 규약 ( |
도서관 | HODI REST API | librsv.korea.ac.kr (인증 불필요) |
LMS API | Canvas REST API | mylms.korea.ac.kr 세션 쿠키 인증 |
브라우저 | Playwright (선택) | 학사 2차 인증 전용 |
트러블슈팅
MCP 서버가 연결되지 않을 때
서버가 정상 동작하는지 확인:
ku-portal-mcp --version서버가 등록되어 있는지 확인:
claude mcp list목록에
ku-portal이 없으면 설치 > 1. MCP 서버 등록을 참고하세요.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 toolskupid_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_searchA
KUPID 포털에서 키워드로 공지사항/학사일정/장학공지를 검색합니다.
제목에 키워드가 포함된 항목을 반환합니다.
Args: keyword: 검색할 키워드 board: 검색 대상 ("all", "notice", "schedule", "scholarship") count: 최대 결과 수 (기본값: 20)
Inputs: keyword (required), board, count. 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
Scored across 31 tools
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.
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.
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.).
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
Related MCP Connectors
PLATO (Pusan National University LMS) MCP server via Moodle Web Service API + ubboard scraping
Korean company facts in English for AI agents: ~830 KOSPI-listed companies (DART profiles, KRW financials, recent filings) and ~110,000 corporate public procurement suppliers (12-month KONEPS contract awards), plus live National Tax Service business status checks. 4 tools, keyless, read-only.
All KR Data tools in one server: Korean business checks, addresses, laws, car flood records & more
Manage your Canvas coursework with quick access to courses, assignments, and grades. Track upcomin…
Related MCP Servers
- FlicenseAqualityNot gradedmaintenanceEnables interaction with Canvas LMS courses and assignments directly from your LLM, allowing you to retrieve, search, and summarize course information, check due dates, and access assignment details without leaving your AI assistant.43,565 npm-
- AlicenseNot gradedqualityDmaintenanceEnables students, instructors, and administrators to interact with Canvas LMS through natural language, covering courses, assignments, grading, user management, reports, and account administration.3,565 npmMIT
- AlicenseAqualityBmaintenanceRead-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.2527 npmMIT
- AlicenseAqualityAmaintenanceEnables 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.71MIT