jys0615/agent-khu

Agent KHU 🎓

MCP 기반 경희대학교 캠퍼스 정보 통합 AI Agent 시스템

Agent KHU는 Anthropic Claude와 Model Context Protocol (MCP)을 활용하여 경희대학교 학생들에게 개인화된 캠퍼스 정보를 제공하는 AI 시스템입니다.

---

✨ 주요 기능

Agentic AI

Claude Sonnet 4가 자율적으로 필요한 정보를 찾아 답변

• Tool-Use 루프: 최대 8회 반복으로 복합 질문 처리
• 실시간 스트리밍: SSE(Server-Sent Events) 기반 토큰 단위 응답
• SLM 3계층 분류: 단순 질문은 로컬 SLM(Ollama) → Groq → Claude 순 라우팅
• 세션 기억: Redis 기반 대화 히스토리 (최근 5턴, 30분 TTL)

개인화

학번·학과·관심분야 기반 맞춤형 정보

• 졸업요건 자동 계산: 입학년도별 맞춤 요건 (컴퓨터공학과 2019~2025학번)
• 캠퍼스별 정보: 서울/국제 캠퍼스 구분

🔌 MCP Streamable HTTP (2025-03-26 표준)

7개의 독립 MCP 서버가 HTTP로 통신을 주고 받으며 응답을 생성합니다.

| MCP 서버 | 포트 | 기능 | 캐시 TTL | |---------|------|------|----------| | classroom | 8101 | 강의실 위치 (DB 조회) | 24시간 | | notice | 8102 | 공지사항 실시간 크롤링 | 2시간 | | meal | 8103 | 학식 메뉴 (Vision AI 파싱) | 1시간 | | library | 8104 | 도서관 좌석·예약 | 1분 | | course | 8105 | 수강신청 정보 (Playwright) | 1시간 | | curriculum | 8106 | 교과과정·졸업요건 | 24시간 | | shuttle | 8107 | 셔틀버스 시간표 | 정적 |

---

🚀 빠른 시작

요구사항

• Docker & Docker Compose
• Anthropic API Key

실행

# 1. 저장소 클론
git clone https://github.com/jys0615/agent-khu.git
cd agent-khu

# 2. 환경변수 설정
cat > .env << EOF
POSTGRES_PASSWORD=yourpassword
ANTHROPIC_API_KEY=sk-ant-...
GROQ_API_KEY=gsk_...          # 선택: SLM fallback용
EOF

# 3. 실행
docker compose up -d

# 4. Ollama SLM 모델 설치 (선택)
docker exec age