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.

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.