Portfolio Details

Agent KHU UI
Agent KHU Architecture

Project information

  • Category: Solo Project · 졸업프로젝트 A+
  • Role: FastAPI · LLM 서버 · MCP 전체 설계·구현
  • Period: 2025.09 ~ 2025.12 (약 4개월)
  • GitHub: github.com/jys0615
  • Stack: Python · FastAPI · LangChain · MCP · Redis · PostgreSQL · Elasticsearch · Docker · APScheduler · Playwright

Agent KHU — MCP 기반 AI 캠퍼스 정보 시스템

Anthropic Claude Sonnet 4와 MCP(Model Context Protocol)를 활용해 통합 캠퍼스 정보를 제공하는 AI 에이전트 시스템. 졸업학점·수강신청·도서관 좌석·식당 메뉴·공지사항 등 6개 MCP 서버를 단독으로 설계·구현하고 운영까지 책임진 졸업프로젝트입니다.

핵심 기여 1 — I/O 병목 정량 진단 → 응답시간 67% 단축
  • cProfile로 전 구간 프로파일링 → 외부 스크래핑 I/O가 전체 시간의 78% 차지 특정
  • Redis TTL 계층화 (졸업요건·강의실 24h / 공지 2h / 식단 1h / 도서관 1m)
  • APScheduler 선제 갱신으로 캐시 스탬피드 방지
  • asyncio.gather()로 직렬 MCP 호출 → 병렬 처리 전환
  • 결과: 16.6s → 5.5s (67% 단축) · 에러율 15% → 2% · 캐시 히트율 95%
핵심 기여 2 — LLM/SLM 하이브리드 라우팅
  • 단순 조회형 질의 → SLM 또는 캐시 직행 / 복합 추론만 Claude Sonnet 4 실행
  • 전체 질의의 62%를 LLM 호출 없이 처리 · 단순 질의 응답속도 85% 개선
핵심 기여 3 — MCP 세션 독립 재설계
  • 요청마다 독립 세션(create/terminate) 생성 → Context 오염 버그 완전 제거
  • Graceful Degradation: 특정 MCP 장애 시 나머지 5개 기능 정상 유지