# korean-vocational-learning-map-mcp [Health: Active]

**Category:** 🎓 Education  
**Repository:** https://github.com/raphysicst-create/korean-vocational-learning-map-mcp  
**GitHub Stars:** 2  
**npm Downloads (last month):** 159  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/korean-vocational-learning-map-mcp

## Description
한국 특성화고 전문교과 2022 개정 교육과정 학습 그래프 MCP 서버 (전공일반·전문공통 성취기준 원문 수록)

## Tools
Capabilities this server exposes over MCP:

- **list_major_fields** — 17개 계열 + 전문공통의 개요(과목 수·성취기준 수·근거 별책)를 반환한다. 전 계열이 수록되어 있다.
- **list_curricula** — 필터가 없으면 계열 단위 요약을 반환한다. majorField를 주면 그 계열의 과목 목록을 반환한다.
- **search_standards** — 성취기준을 코드·키워드·필터로 검색해 요약 목록을 반환한다. 상세는 get_standard로 조회한다.
- **search_standard_text** — 성취기준 공식 원문 전문에서 키워드를 검색해 코드와 스니펫을 반환한다. 상세 원문은 get_standard의 officialText.
- **get_standard** — 성취기준 코드([간기 01-01] — 공백 유무 무관)로 전체 레코드, 공식 원문, 연결 주제, 코드 구조 해석을 조회한다. 일부 코드는 여러 과목·계열이 공유할 수 있어 subject·majorField로 구분한다.
- **search_topics** — 세부 학습 주제를 키워드·필터로 검색한다. 주제는 상류 기계 파생물(candidate)이다. 상세는 get_topic.
- **get_topic** — 주제 ID로 전체 레코드를 조회한다. 설명·증거·발문은 상류 기계 파생물(candidate)이다.
- **get_prerequisites** — 주제의 선수(prerequisites)/후속(unlocks) 관계를 조회한다. 전문교과는 공식 선수관계가 희소해 빈 결과가 정상일 수 있다. depth=all이면 전이 경로를 위상 순서로 반환한다.
- **get_learning_roadmap** — 과목의 성취기준을 영역→클러스터 계층으로 집계한 로드맵을 반환한다. 기존 데이터의 집계이며 새 순서를 만들지 않는다.
- **list_clusters** — 학습 클러스터(단원 묶음) 목록을 조회한다. clusterId를 주면 단건 전체 레코드를 반환한다. 목록은 limit·offset으로 페이지를 넘긴다.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "korean-vocational-learning-map-mcp": {
    "command": "npx",
    "args": ["-y","korean-vocational-learning-map-mcp"]
  }
}
```

## Documentation & README

# korean-vocational-learning-map-mcp

한국 특성화고·마이스터고 전문교과 2022 개정 교육과정(국가교육위원회 고시 제2024-3호) 학습 그래프 MCP 서버.
성취기준 47,625건(전문교과 전 범위, 공식 원문 전량 수록) · 주제 47,625건 · 17계열 + 전문공통을 패키지에 내장하고 stdio로 완전 로컬 동작한다. 도구 10종.

## 설치

```json
{ "mcpServers": { "korean-vocational-learning-map": {
  "command": "npx", "args": ["-y", "korean-vocational-learning-map-mcp"] } } }
```

## 수록 범위 (v0.2)

- **전문교과 전 범위**: 전공일반 216 + 전공실무 309 + 전문공통 3 = 528과목, 성취기준 47,625건.
  모든 성취기준에 공식 원문(국가교육위원회 고시 제2024-3호 별책23~39) 수록.
- 주제 47,625건 · 클러스터 4,480건 · 선수관계 288건(희소 — 공식 문서 명시분만).
- 보통교과·특목 계열은 [korean-secondary-learning-map-mcp](https://github.com/raphysicst-create/korean-secondary-learning-map-mcp) 사용.

## 도구 10종

list_major_fields · list_curricula · search_standards · search_standard_text · get_standard · search_topics · get_topic · get_prerequisites · get_learning_roadmap · list_clusters

## 데이터 특성 고지

- 세부 학습 주제(topics)의 설명·관찰 증거·평가 발문은 상류 데이터의 기계 파생물(candidate)이다.
- 전문교과는 공식 문서에 선수관계 명시가 희소해 get_prerequisites가 빈 결과를 주는 것이 정상일 수 있다.
- 교육부·국가교육위원회·NCIC의 공식 산출물이 아니다.

## 라이선스·출처

MIT. 데이터 원천: [DECK6/korean-secondary-learning-map](https://github.com/DECK6/korean-secondary-learning-map)(MIT).
성취기준 원문은 국가교육위원회 고시의 별책으로서 저작권법 제7조 제2호에 따라 보호받지 않는 저작물입니다. 정확성·추적성을 위한 출처는 NOTICE.md를 참조하세요.

수록 원문 기준 고시는 국가교육위원회 고시 제2024-3호(2024.8.16.) 별책23~39이며, 이후 개정 고시분은 반영되어 있지 않습니다.

## 패키지 크기

`npm pack --dry-run` 기준 tarball 10.4MB(압축) / unpacked 122.3MB, 총 87개 파일(`src/` 7 · `data/` 76 · README·LICENSE·NOTICE·package.json). `src/`·`data/`·README·LICENSE·NOTICE만 포함.