강원대 MCP 서버 (비공식)

강원대학교 춘천캠퍼스의 공개 정보를 조회하는 MCP(Model Context Protocol) 서버입니다. Claude Desktop, Cursor, Cline 등 MCP를 지원하는 클라이언트에서 자연어로 학사일정·학식·공지·버스 정보를 조회할 수 있습니다.

⚠️ 비공식 프로젝트입니다. 강원대학교와 무관한 학생 제작 도구이며, 공개 웹페이지 및 공공데이터포털 API에서 정보를 수집합니다. 학교 사이트 구조가 바뀌면 일부 기능이 동작하지 않을 수 있습니다. 로그인이 필요한 정보(수강신청·성적·도서관 좌석 등)는 제공하지 않습니다.

설치

uv sync

로컬 클라이언트 등록 (Claude Desktop 예시)

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "kangwon": {
      "command": "uv",
      "args": ["run", "--directory", "/절대경로/knu-mcp", "knu-mcp"],
      "env": { "KNU_BUS_API_KEY": "발급받은_공공데이터포털_인증키" }
    }
  }
}

KNU_BUS_API_KEY는 버스 도착 정보 tool에만 필요합니다(아래 참조). 없으면 버스 tool만 에러를 반환하고 나머지는 정상 동작합니다.

제공 도구

tool	설명
get_academic_calendar(year=올해)	학사일정(해당 연도 전체)
get_cafeteria_menu(restaurant="백록관", week=0)	학식 식단. restaurant: 백록관/천지관/두리, week: 0=이번주,1=다음주
get_all_cafeteria_menus(week=0)	3식당 학식 일괄
search_notices(query, limit=10)	학사공지(메인 홈페이지) 최근분에서 제목 검색
get_shuttle_schedule()	교내 순환버스(두리버스) 시간표. 정규학기만 운영
get_next_shuttle()	두리버스 현재 시각 기준 다음 출발
get_bus_arrival(stop="강원대정문", route="300")	시내버스 실시간 도착. stop: 강원대정문/후문/중앙도서관/백록관/학병원/남춘천역/춘천역/시외버스터미널

버스 API 키 (get_bus_arrival 전용)

시내버스 실시간 도착은 공공데이터포털 TAGO 버스도착정보 API를 사용합니다.

1. data.go.kr 로그인 → "국토교통부_(TAGO)_버스도착정보" 활용신청(개발계정, 즉시 승인)
2. 발급된 일반 인증키(Decoding) 를 환경변수 KNU_BUS_API_KEY로 설정

키는 코드에 하드코딩하지 말고 환경변수로만 전달합니다.

전송 모드

기본은 로컬 클라이언트용 stdio. 원격(클라우드/PlayMCP) 배포 시 streamable-http:

KNU_MCP_TRANSPORT=streamable-http PORT=8000 uv run knu-mcp
# 엔드포인트: http://<host>:<PORT>/mcp

환경변수: KNU_MCP_TRANSPORT(stdio|sse|streamable-http, 기본 stdio), PORT(http 포트, 기본 8000).

개발

uv run pytest              # 단위 테스트 (네트워크 안 탐)
KNU_BUS_API_KEY=<키> uv run python scripts/e2e_smoke.py   # E2E 스모크 (실 네트워크)

라이선스

MIT