korea-university-mcp
Integrates Korean university information APIs (대학알리미 and 공공데이터포털) into a single MCP server and CLI, enabling search, description, and execution of university data operations such as student, faculty, and finance statistics.
README
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
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.