Korean Secondary Learning Map Mcp

io.github.raphysicst-createPublished by GitHub account raphysicst-createv0.3.0Updated Oct 24, 2026

한국 중등 2022 개정 교육과정 학습 그래프 MCP 서버 (중학교 714 · 고교 3,124 성취기준 · 원문 수록 · 중→고 전이)

VerifiedSTDIODesktop onlyProductivity & WorkflowKnowledge & Memory

Overview

AI-generated overview

Local MCP server that lets an assistant search Korea's 2022 revised secondary curriculum: achievement standards, learning topics, prerequisites and…

What you can do
  • Browse curricula and subjects by school level and subject group
  • Search achievement standards by code or keyword, and search their official full text for matching snippets
  • Retrieve a standard's full record with official text and linked topics, or a topic's evidence, assessment items and sources
  • Look up prerequisites and follow-ups, including a topologically sorted transitive learning path
  • Build a subject roadmap grouped by area and cluster, and list learning clusters
  • Look up middle-to-high transitions and recommended course sequences between high school subjects
When to use it
Useful for teachers, curriculum designers, tutors and students who want an assistant to answer questions grounded in Korea's 2022 revised secondary curriculum, plan learning sequences, or trace how middle school topics connect to high school courses.
Requirements
Runs locally over stdio via npx; Node.js 20.11 or newer with npx is required. No accounts, API keys or environment variables are declared. Data ships with the package, so no pipeline rebuild is needed for normal use.
Before you install
Read-only lookup server; no credentials or write actions are declared. Coverage excludes vocational high school specialized subjects, and the 2026 revision of the curriculum is not reflected. Prerequisite, transition and course relations are a recommended model, not a claim of universal learning order, and the project is not an official Ministry of Education output.

Installation

In SourceWeft

  1. Open Korean Secondary Learning Map Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

korean-secondary-learning-map-mcp

한국 중등(중학교·고등학교 보통교과·특목 계열[과학·예술·체육]) 2022 개정 교육과정 학습 그래프를 AI가 조회하게 해주는 MCP(Model Context Protocol) 서버입니다. Claude Desktop, Claude Code 등 MCP를 지원하는 AI 클라이언트에 설정 한 줄로 연결하면, AI가 성취기준·학습 주제·선수관계·중→고 전이를 직접 검색해서 답합니다.

데이터 규모

항목수량
과목(교육과정)255 (중학교 24 · 고교 231)
성취기준3,838 (중학교 714 · 고교 3,124)
성취기준 원문3,838 (자동 추출 3,824 + 수식 수동 보정 14)
세부 학습 주제5,284
선수관계 (교과 내)266 (중학교 56 · 고교 210)
학습 클러스터838
중→고 전이175
과목관계 (고교 과목 간 선후)39

빌드 시 드롭된 항목:

  • 고교 선수관계는 DECK6 원본 508건 중 298건이 특성화고 전문교과 과목 제외로 드롭되어 210건만 포함되었습니다(중학교 56건과 합쳐 266건).
  • 중→고 전이는 원본 대비 드롭 0건(175건 전부 포함).
  • 과목관계는 원본 39건 전부가 포함 범위 안에 있어 드롭 없이 39건 전부 포함되었습니다.

범위와 한계

  • 특성화고 전문교과(47,625건)는 포함하지 않습니다. 이 서버는 중학교 전체와 고등학교 보통교과(공통·일반선택·진로선택·융합선택) + 특목 계열(과학·예술·체육, 964건)을 다룹니다. 단, 「연극」과목(13건)은 DECK6 분류상 예술 계열이지만 실제로는 별책4(보통교과)에 수록된 과목이라 특목 계열 확장 이전부터 포함되어 있었습니다.
  • 11개 코드(12스문·12심독 계열)는 서로 다른 두 과목이 공유합니다 — get_standard에서 subject 파라미터로 구분해야 합니다.
  • 선수관계·전이·과목관계는 공식 문서(별책3·별책4·별책20·별책21·별책22, DECK6 근거)가 직접 뒷받침하는 관계만 수록했습니다. 초등판 대비 선수관계 수가 상대적으로 적은 것은 데이터가 부실해서가 아니라, 근거 없는 추정 관계를 배제했기 때문입니다.
  • 선수관계·전이·과목관계는 모델의 추천 구조이며 보편적 학습 순서 주장이 아닙니다.

도구 11종

검색·목록형 도구 6종(list_curricula, search_standards, search_topics, search_standard_text, get_learning_roadmap, list_clusters)은 schoolLevel(middle | high) 필터를 지원합니다. 나머지 5종(get_standard, get_topic, get_prerequisites, get_transitions, get_course_pathway)은 ID·코드 단건 조회라 필터가 없습니다.

도구설명
list_curricula필터 없으면 학교급·교과군 요약, schoolLevel/subjectGroup 지정 시 과목 목록
search_standards성취기준을 코드·키워드·필터로 검색 (요약 목록)
search_standard_text성취기준 공식 원문 전문에서 키워드 검색 (매칭 스니펫)
get_standard성취기준 코드로 전체 레코드 + 공식 원문 + 연결 주제 조회. 코드 공유 과목은 subject로 구분
search_topics세부 학습 주제 검색 (요약 목록)
get_topic주제 ID로 관찰 증거·평가 문항·출처를 포함한 전체 레코드 조회
get_prerequisites주제의 선수/후속 관계 조회. depth: "all"이면 위상 정렬된 전이적 학습 경로 반환
get_learning_roadmap과목의 성취기준을 영역→클러스터 계층으로 집계한 로드맵
list_clusters학습 클러스터 목록·상세 조회
get_transitions주제 ID 또는 성취기준 코드로 중→고 전이(심화 연계)를 양방향 조회
get_course_pathway과목명으로 고교 과목 간 권장 선후 흐름(예: 영어Ⅰ→영어Ⅱ) 조회

설치

Claude Code

bash
claude mcp add curriculum-kr-secondary -- npx -y korean-secondary-learning-map-mcp

모든 프로젝트에서 쓰려면 사용자 범위로:

bash
claude mcp add -s user curriculum-kr-secondary -- npx -y korean-secondary-learning-map-mcp

Claude Desktop

설정 파일에 추가합니다. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

json
{  "mcpServers": {    "curriculum-kr-secondary": {      "command": "npx",      "args": ["-y", "korean-secondary-learning-map-mcp"]    }  }}

저장 후 Claude Desktop을 재시작하면 도구 11종이 로드됩니다.

요구 사항

  • Node.js ≥ 20.11 (npx 포함)

로컬 개발

bash
git clone https://github.com/raphysicst-create/korean-secondary-learning-map-mcp.gitcd korean-secondary-learning-map-mcpnpm installnpm test          # node --test tests/*.test.mjs

data/kr/의 데이터는 커밋되어 있으므로 일반 사용에는 파이프라인 재현이 필요 없습니다. 데이터를 재구축하려면 다음 순서로 실행합니다.

bash
npm run pipeline:fetch     # DECK6 원본 + NCIC PDF 7권 확보·해시 검증 (.cache/, git 미추적)npm run pipeline:build     # DECK6 원본에서 범위 필터링해 data/kr/*.json 생성npm run pipeline:extract   # PDF에서 성취기준 원문 추출 (실패분은 pipeline/exceptions.json으로 수동 보정)npm run pipeline:verify    # 전수 검증(수량 게이트·참조 무결성) + manifest.json 해시 기록

PDF 7권(별책3, 별책4 Ⅰ·Ⅱ·Ⅲ, 별책20·21·22)은 저장소 밖에 있어야 하며, PDF_DIR 환경 변수(기본값: 저장소 부모 폴더)에서 찾습니다.

법적 고지

  • MIT — 기반 데이터셋(학습 주제·선수관계·클러스터·전이·과목관계) 원저작자 DECK6의 저작권 고지를 유지합니다 (고정 커밋 68e6228).
  • 성취기준 원문은 교육부·국가교육위원회 고시의 별책으로서 저작권법 제7조 제2호에 따라 보호받지 않는 저작물입니다. 정확성·추적성을 위해 공식 출처를 표기합니다 — 상세는 NOTICE.md
  • 수록 원문 기준 고시 — 별책3·4·20·21은 교육부 고시 제2022-33호, 별책22는 국가교육위원회 고시 제2024-3호입니다. 별책3·4를 개정한 국가교육위원회 고시 제2026-1호(2026.1.21.) 개정분은 반영되어 있지 않습니다.
  • 이 프로젝트는 교육부·국가교육위원회·NCIC의 공식 산출물이 아니며, 개별 학습자를 진단하지 않습니다.

Source: README.md at commit 964bfae

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.3.0LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.