Korean University Disclosure Indicators (대학알리미) MCP server

academyinfo-mcp

English | 한국어

academyinfo-mcp is an independent, read-only MCP server for factual queries and side-by-side comparison of Korean university disclosure indicators. It uses a bundled local snapshot: no API key and no runtime network connection are required.

This project is not affiliated with, endorsed by, approved by, sponsored by, or maintained by the Ministry of Education, KCUE, KEDI, data.go.kr, academyinfo.go.kr, or any university.

Quickstart

academyinfo-mcp runs with no install, no API key, and no login. It reads a bundled snapshot of Korean university disclosure indicators (대학알리미, KOGL Type 1) and answers factual queries and side-by-side comparisons from your AI assistant.

Claude Desktop

Add to claudedesktopconfig.json (macOS: ~/Library/Application Support/Claude/), then restart Claude Desktop:

{
  "mcpServers": {
    "academyinfo": {
      "command": "npx",
      "args": ["-y", "academyinfo-mcp"]
    }
  }
}

Cursor

Add the same command/args shape to ~/.cursor/mcp.json (or a project .cursor/mcp.json), then reload the MCP server list.

Any MCP stdio client

npx -y academyinfo-mcp

The server speaks MCP over stdio (JSON-RPC on stdout, diagnostics on stderr).

Hosted endpoint (nothing installed)

For a client that cannot run a local process. A client that registers connectors by a URL field (for example claude.ai custom connectors) takes just the address:

https://academyinfo-mcp-433006350023.asia-northeast3.run.app/mcp

A client that takes a pasted mcpServers object takes this entry:

{
  "mcpServers": {
    "academyinfo": {
      "description": "대학알리미 공시데이터 — 488개 대학·캠퍼스 17개 지표 비교",
      "url": "https://academyinfo-mcp-433006350023.asia-northeast3.run.app/mcp"
    }
  }
}

No credentials, so no headers. Same bundled snapshot and same eight tools as the local form.

This is a personal deployment offered as-is: it can go away without notice, and it is not covered by any availability guarantee (see Support). For work you need to reproduce, prefer the local form and pin a version — academyinfo-mcp@0.4.0.

More on the pasted-object format, including the transport field that does not belong in it, is in examples/.

Try it

Ask your assistant something like:

"전남대와 부산대의 취업률과 경쟁률을 비교해줘."

The server never guesses an ambiguous name. "전남대학교" matches two campuses, so the first explore_universities call returns status: "ambiguous" with the candidates instead of a table:

전남대학교 → 2 candidates
    전남대학교 / 본교       (국립, 광주)
    전남대학교 / 제2캠퍼스  (국립, 전남)

Pick a campus and ask again (assistants usually do this follow-up on their own):

"전남대학교 본교와 부산대학교로 비교해줘."

The second call returns status: "ok" with each institution's values and the source, year, and unit attached — for example (2025 bundled snapshot):

This two-step flow is the designed behavior, not a failure: ambiguous names return candidate campuses instead of guessing, and comparisons never rank, score, or pick a winner — the numbers are presented as-is with provenance so you decide.

Evidence-scoped status

Implemented in this checkout:

Shortened. The full README is on GitHub.