korean-special-education-curriculum-mcp
This server is a read-only MCP tool for searching and retrieving the official 2022 revised Korean special education curriculum (middle/high school), with source tracking and no login required.
get_coverage_report: Check which statutory texts and supplementary materials are included or missing in the local dataset.
list_official_sources: List official notices, separate volumes, URLs, extraction status, and chunk counts.
search_curriculum: Search curriculum content by keyword, school level, curriculum type, subject, material kind, or specific source, returning official source info, page numbers, and URLs.
get_curriculum_chunk: Retrieve a longer original-text chunk using a
sourceIdandchunkIdfor deeper context.find_achievement_standard: Look up achievement standard codes (e.g.,
[12국어01-02]or9국어01-01) and return their source and context.All tools are read-only, local, and do not require authentication or API keys.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@korean-special-education-curriculum-mcp 고등학교 기본 교육과정 국어 성취기준을 쪽수와 함께 찾아줘."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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:mcpsources: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
kordocLocal search corpus of 26,354 pages and 112,889 chunks
Middle school/high school and basic/common/elective-centered filters
materialKindfilter separating statutory source texts, commentaries, achievement/assessment, and research materialsRead-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 serveOfficial 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:fullMCP Tools
list_official_sources: current baseline, sources, preparation status, and chunk countsget_coverage_report: preparation and missing status of current statutory source texts and supplementary materialssearch_curriculum: filtered search by keyword, school level, curriculum type, subject, and material kindget_curriculum_chunk: retrieve the source-text context and location of search resultsfind_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.jsAn 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 toolsfind_achievement_standard성취기준 코드 조회ARead-onlyIdempotent
예: 9국어01-01 또는 [12진로01-01] 같은 성취기준 코드를 찾아 출처와 문맥을 반환합니다.
Inputs: code (required), limit, curriculumType.
get_coverage_report교육과정 수록 범위·완전성 확인ARead-onlyIdempotent
중·고등학교 특수교육 고시 원문과 준용 일반교육과정 별책의 수록 완전성, 아직 별도 수집 중인 보조자료 범위를 보고합니다.
Inputs: no named parameters.
get_curriculum_chunk교육과정 원문 청크 조회ARead-onlyIdempotent
검색 결과의 sourceId와 chunkId로 해당 원문 청크와 정확한 출처 위치를 조회합니다.
Inputs: chunkId (required), sourceId (required), maxChars.
list_official_sources공식 출처 및 준비 상태 확인ARead-onlyIdempotent
현행 기준일, 고시·별책, 원문 URL, 추출 여부와 청크 수를 나열합니다.
Inputs: no named parameters.
search_curriculum특수교육 교육과정 검색ARead-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
Scored across 5 tools
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.
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.
Five tools is well-scoped for a specialized curriculum server, covering search, retrieval, source listing, coverage reporting, and standard lookup without redundancy.
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
Related MCP Connectors
대한민국 법령·조문·별표·연혁·판례·해석례를 법제처 국가법령정보 OPEN API 로 찾아보는 읽기 전용 MCP 서버. 코어 12 + 보조 12 도구.
Public read-only MCP access to digital learning concepts, semantic relationships, and citations.
Read-only, no-auth MCP server over Human x AI's Content Hub and confirmed 2027 facts.
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceThis 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.2MIT
- FlicenseNot gradedqualityBmaintenanceAn MCP server for creating and validating lesson plans based on the 2022 revised Korean middle school math curriculum, providing context, validation, and rendering tools.-
- FlicenseNot gradedqualityDmaintenanceA 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-
- AlicenseNot gradedqualityDmaintenanceProvides access to the Korean elementary 2022 revised curriculum learning graph, enabling users to search and retrieve curriculum standards, learning topics, prerequisites, and roadmaps from a fully local database.104 npm16MIT