korea-university-mcp

대학알리미와 공공데이터포털의 분야별 대학정보 API를 하나의 MCP 서버와 CLI로 통합하는 프로젝트입니다.

현재 버전은 데이터 접근 기반 구축용 MVP입니다. 정원조정, 평가등급, 정책판단 등의 업무 로직은 포함하지 않습니다.

현재 지원 범위

• 대학 기본정보
• 대학 및 전문대학정보
• 대학별 학과정보
• 학생 현황
• 교원·연구 현황
• 교육여건 현황
• 재정 현황
• 산학협력 현황

공공데이터포털 서비스키는 한 번만 설정하며, 각 분야 API의 승인 상태는 공공데이터포털에서 별도로 관리합니다.

설치

npm install
npm run build

환경변수:

DATA_GO_KR_SERVICE_KEY=발급받은키

MCP 서버 실행

npx korea-university-mcp

또는 개발 중:

npm run dev

자동 설정

npx korea-university-mcp setup

CLI

korea-university list
korea-university list --query "중도탈락"
korea-university describe student getComparisonDropOutStudentCrntSt
korea-university call student getComparisonDropOutStudentCrntSt --params '{"pageNo":1,"numOfRows":100}'
korea-university doctor
korea-university http

MCP 도구

도구	기능
discover_datasets	분야·지표 검색
describe_operation	데이터셋·오퍼레이션 설명
execute_operation	분야별 API 실행
doctor	키·레지스트리·실호출 진단

오류 처리

오류를 감추지 않습니다. 다음 정보를 구조화하여 반환합니다.

• MCP 오류코드
• 사용자용 설명
• 해결방법
• 재시도 가능 여부
• 공공데이터포털 HTTP 상태·결과코드·결과메시지
• 요청 ID

서비스키와 전체 요청 URL은 노출하지 않습니다.

중요: 실제 요청 파라미터

분야별 API는 오퍼레이션마다 요청변수가 다릅니다. MVP의 execute_operation은 공공데이터포털 Swagger 명세의 요청변수를 그대로 전달합니다. 서비스키를 설정한 뒤 실제 응답을 검증하여 오퍼레이션별 필수 파라미터와 응답 스키마를 단계적으로 레지스트리에 추가해야 합니다.

배포

• 로컬 STDIO: 기본 실행
• 원격 Streamable HTTP: korea-university http
• Docker: Dockerfile
• npm: 태그 푸시 시 GitHub Actions 배포
• Claude Code 플러그인: .claude-plugin 및 .mcp.json

출처

• 공공데이터포털 한국대학교육협의회 대학정보 API
• Model Context Protocol 공식 TypeScript SDK

라이선스

MIT