Skip to main content
Glama
korean-special-education-curriculum-mcp

korean-special-education-curriculum-mcp

by sonbyobyo

Korea Special Education Curriculum MCP

A read-only MCP server for exploring, with sources, the basic, common, and elective-centered curricula of middle and high school in the Republic of Korea's 2022 revised special education curriculum.

The current version is v0.1.0-candidate. Rather than distributing official source texts in the repository, it reproduces a local search corpus linked to notices, separate volumes, file hashes, and page locations.

Quick Start

Prerequisites are Git and Node.js 20 or higher. After cloning the repository, run the following command.

git clone <이 저장소의 GitHub URL>
cd korean-special-education-curriculum-mcp
npm install
npm run sources:prepare
npm run check
npm run test:mcp

sources:prepare automatically downloads and structures materials obtainable from public URLs. If optional supplementary materials requiring a login to the publishing agency are absent, it only prints a warning and continues preparing the remaining materials. Use get_coverage_report to check the actual scope available to the server and any missing materials.

OS-specific connection methods and examples for first-time users are documented in docs/USER_GUIDE.md.

Related MCP server: ClassCraftMCP

Scope

  • Middle school and high school

  • Basic curriculum

  • Common curriculum

  • Elective-centered curriculum

  • Ministry of Education Notice No. 2022-34 and subsequent revision notices

The current reference date is 2026-08-19, and National Education Commission Notice No. 2026-2 serves as the special education baseline. Notice No. 2024-3 is also collected to verify the application relationship of general subjects in the common and elective-centered curricula.

Current Implementation

  • 81 official sources prepared: 35 statutory curricula, 1 commentary, 17 assessment materials, 28 research and review materials

  • 29 items in the current statutory scope: Special Education Separate Volumes 1, 2, and 3, and 26 general curriculum separate volumes applied mutatis mutandis to middle and high schools

  • File signature verification, SHA-256, final URL, and collection timestamp recording

  • HWP/HWPX/PDF → Markdown and structural chunk conversion using kordoc

  • Local search corpus of 26,354 pages and 112,889 chunks

  • Middle school/high school and basic/common/elective-centered filters

  • materialKind filter separating statutory source texts, commentaries, achievement/assessment, and research materials

  • Read-only STDIO MCP including source URLs, notice numbers, page counts, and table-of-contents paths

Development

npm install
npm run sources:prepare
npm run check
npm run test:mcp
npm run serve

Official document downloads and extraction results are subject to .gitignore. Reproduction information is recorded in sources/official/source-receipts.json.

Statutory curricula and public supplementary materials do not need to be downloaded separately. npm run sources:prepare downloads, verifies, and converts them from official URLs. Eduable member-access materials are optional; the catalog records the original file names and ZIP internal paths in manualAcquisition. If you obtain the originals yourself and place them under the designated English file names in sources/official/files/, they are included in the full corpus. When missing, the collector prints the required files and target names, then continues processing the remaining materials that can be collected automatically.

Whether all materials are fully prepared locally can be strictly verified with the following command.

npm run check:full

MCP Tools

  • list_official_sources: current baseline, sources, preparation status, and chunk counts

  • get_coverage_report: preparation and missing status of current statutory source texts and supplementary materials

  • search_curriculum: filtered search by keyword, school level, curriculum type, subject, and material kind

  • get_curriculum_chunk: retrieve the source-text context and location of search results

  • find_achievement_standard: search achievement standard codes

MCP Connection

It runs as a local STDIO server. After building, use the following command in the project-scoped .codex/config.toml or Codex MCP settings.

node <absolute-project-path>/dist/src/server.js

An example Codex project configuration is as follows.

[mcp_servers.korean-special-education-curriculum]
command = "node"
args = ["<absolute-project-path>/dist/src/server.js"]

Run npm run sources:prepare and npm run build once before connecting the server.

After connecting, it is recommended to first confirm the scope with a request such as the following.

특수교육 MCP의 get_coverage_report로 현재 수록 범위를 확인해줘.

Example follow-up questions are as follows.

고등학교 기본 교육과정 국어 성취기준을 고시 원문, 쪽수, URL과 함께 찾아줘.
[12국어01-02]의 원문과 성취기준 해설을 구분해서 보여줘.
진로와 직업 과목에서 안전과 관련된 내용을 고시 원문만 대상으로 검색해줘.

Data Interpretation Scope

All general curriculum separate volumes applied mutatis mutandis by Separate Volume 2 of National Education Commission Notice No. 2026-2 that fall within the middle and high school scope are included: Separate Volumes 3, 4, 7, 12, 14, 18, 19, 22, 23~39, and 41. The 29 current statutory source texts undergo an independent completeness check in get_coverage_report. The 6 previous notices are preserved for change history and source verification but are excluded from the default search.

Commentaries, assessment materials, and research materials are not documents with the same legal effect as the statutory curriculum, so they are marked as a separate material kind. The index covers 26 middle and high school scope items from the National Institute of Special Education's 2022 special education curriculum draft research, the 2025 national curriculum special education survey and review report, assessment guides and basic curriculum assessment materials, 2026 high school achievement level materials, and physiotherapy and vocational life achievement levels and minimum achievement level guarantee guidance materials. Eduable member-access materials are processed locally only from originals obtained directly by users and are not included in Git. Known gaps in the defined special education-only supplementary material scope can be confirmed as 0 items in get_coverage_report.

Rights and Non-Endorsement Notice

This project is not an official product of the Ministry of Education, the National Education Commission, or NCIC. Official documents follow the terms of use of their respective original sources, and this repository's MIT license does not apply to official documents. See PROVENANCE.md, ACKNOWLEDGEMENTS.md, and THIRD_PARTY_NOTICES.md for details.

See CONTRIBUTING.md for reporting errors and contributing improvements, and SECURITY.md for reporting security issues.

Available Tools

5 tools
find_achievement_standard성취기준 코드 조회A
Read-onlyIdempotent

예: 9국어01-01 또는 [12진로01-01] 같은 성취기준 코드를 찾아 출처와 문맥을 반환합니다.

Inputs: code (required), limit, curriculumType.

get_coverage_report교육과정 수록 범위·완전성 확인A
Read-onlyIdempotent

중·고등학교 특수교육 고시 원문과 준용 일반교육과정 별책의 수록 완전성, 아직 별도 수집 중인 보조자료 범위를 보고합니다.

Inputs: no named parameters.

get_curriculum_chunk교육과정 원문 청크 조회A
Read-onlyIdempotent

검색 결과의 sourceId와 chunkId로 해당 원문 청크와 정확한 출처 위치를 조회합니다.

Inputs: chunkId (required), sourceId (required), maxChars.

list_official_sources공식 출처 및 준비 상태 확인A
Read-onlyIdempotent

현행 기준일, 고시·별책, 원문 URL, 추출 여부와 청크 수를 나열합니다.

Inputs: no named parameters.

search_curriculum특수교육 교육과정 검색A
Read-onlyIdempotent

중·고등학교 특수교육 교육과정 고시 원문 또는 별도 해설서 청크를 검색합니다. 결과마다 자료 유형, 고시·자료명, 쪽수, 목차 경로와 공식 출처 URL을 반환합니다.

Inputs: query (required), limit, subject, sourceIds, +4 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 5 tools

    Disambiguation4/5

    The tools are mostly distinct: coverage report, source listing, search, chunk retrieval, and achievement standard lookup. However, search_curriculum and find_achievement_standard could overlap when searching for specific standards, though the latter is more targeted.

    Naming Consistency4/5

    Tool names follow a consistent verb_noun pattern (get_, list_, search_, find_). Minor deviation: 'get_coverage_report' and 'get_curriculum_chunk' both use 'get' but target different resources, which is acceptable.

    Tool Count5/5

    Five tools is well-scoped for a specialized curriculum server, covering search, retrieval, source listing, coverage reporting, and standard lookup without redundancy.

    Completeness4/5

    The surface covers core operations: listing sources, searching, retrieving chunks, and finding standards. Minor gaps like direct browsing of curriculum structure or filtering by grade/subject are not present, but the provided tools likely suffice for typical queries.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      This MCP server enables searching Korean construction standards (KDS/KCS), laws from the Ministry of Government Legislation, administrative rules and interpretations, and optionally local water/wastewater design manuals to generate grounded evidence packages for engineering answers.
      2
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A server that enables checking and managing learning paths based on the 2022 Korean national curriculum, including child profile management, curriculum search, prerequisite tracing, and learning check creation with deterministic state assessment.
      1
      -