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

korean-special-education-curriculum-mcp

by sonbyobyo

MCP для учебной программы специального образования Кореи

Это сервер MCP, предназначенный только для чтения, для поиска по базовым, общим и предметно-ориентированным учебным программам средней и старшей школы в рамках пересмотренной учебной программы специального образования Республики Корея 2022 года, с указанием источников.

Текущая версия — v0.1.0-candidate. Официальные оригинальные тексты не распространяются в репозитории; вместо этого воспроизводится локальный поисковый корпус, привязанный к официальным уведомлениям, приложениям, хешам файлов и расположению страниц.

Быстрый старт

Требуются Git и Node.js версии 20 или выше. После клонирования репозитория выполните следующую команду.

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 автоматически загружает и структурирует материалы, доступные по публичным URL-адресам. Если отсутствуют дополнительные материалы, требующие входа в систему издателя, выводится только предупреждение, и подготовка остальных материалов продолжается. Фактический объем доступного серверу и недостающие материалы можно проверить с помощью get_coverage_report.

Методы подключения и примеры для различных операционных систем для новых пользователей описаны в docs/USER_GUIDE.md.

Related MCP server: ClassCraftMCP

Сфера применения

  • Средняя и старшая школа

  • Базовая учебная программа

  • Общая учебная программа

  • Предметно-ориентированная учебная программа

  • Уведомление Министерства образования № 2022-34 и последующие уведомления о внесении изменений

Текущая эталонная дата — 2026-08-19, а в качестве базиса для специального образования принимается уведомление Национальной комиссии по образованию № 2026-2. Для проверки взаимосвязи применения общих предметов в вариантах общей и предметно-ориентированной учебных программ также собирается уведомление № 2024-3.

Текущая реализация

  • Подготовлено 81 официальных источников: 35 законодательных учебных программ, 1 разъяснение, 17 материалов для оценивания, 28 исследовательских и контрольно-проверочных материалов.

  • Действующих законодательных единиц — 29: приложения 1, 2 и 3 по специальному образованию, а также 26 приложений к обычной общеобразовательной учебной программе, применяемых в средней и старшей школе

  • Проверка сигнатур файлов, запись SHA-256, конечного URL-адреса и времени сбора данных

  • Конвертация HWP/HWPX/PDF в Markdown и структурированные сегменты с помощью kordoc

  • Локальный поисковый корпус: 26 354 страницы, 112 889 сегментов

  • Фильтры по типу учебного заведения (средняя/старшая школа) и типу учебной программы (базовая/общая/предметно-ориентированная)

  • Фильтр materialKind, разделяющий законодательные оригиналы, разъяснения, материалы по достижениям/оцениванию и исследовательские материалы

  • MCP STDIO только для чтения, включающий URL источника, номер уведомления, номер страницы и путь по разделу

Разработка

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

Результаты загрузки и извлечения официальных документов исключены через .gitignore. Информация для воспроизведения записывается в sources/official/source-receipts.json.

Законодательные учебные программы и публичные дополнительные материалы загружать отдельно не нужно. npm run sources:prepare загружает их с официальных URL-адресов, проверяет и преобразует. Материалы с доступом для членов Edunet являются необязательными; в каталоге в поле manualAcquisition указываются исходное имя файла и путь внутри ZIP-архива. Если у вас есть такие исходные файлы, поместите их по указанным в sources/official/files/ английским именам — они будут включены в полный корпус. В случае их отсутствия сборщик выводит список необходимых файлов и целевых имён, после чего продолжает обработку остальных материалов, которые могут быть собраны автоматически.

Строгая проверка наличия всех материалов в локальной системе выполняется следующей командой.

npm run check:full

Инструменты MCP

  • list_official_sources: список действующих базисов, источников, статусов готовности и количества сегментов

  • get_coverage_report: готовность и отсутствие действующих законодательных оригиналов и дополнительных материалов

  • search_curriculum: поиск с фильтрами по ключевым словам, ступени школы, типу учебной программы, предмету и типу материала

  • get_curriculum_chunk: получение контекста и расположения исходного текста по результатам поиска

  • find_achievement_standard: поиск по кодам стандартов достижения

Подключение MCP

Сервер запускается как локальный STDIO-сервер. После сборки используйте следующую команду в .codex/config.toml в области проекта или в настройках MCP для Codex.

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

Пример конфигурации проекта Codex:

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

Перед подключением сервера один раз выполните npm run sources:prepare и npm run build.

После подключения рекомендуется сначала запросить определение границ следующим образом:

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

Примеры последующих запросов:

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

Сфера применения данных

Включаются все одиннадцать приложений, применяемых к средней и старшей школе (приложения 3, 4, 7, 12, 14, 18, 19, 22, 23-39, 41) из общей учебной программы, на которые ссылается приложение 2 уведомления Национальной комиссии по образованию № 2026-2. 29 действующих законодательных документов проходят независимую проверку полноты в get_coverage_report. Шесть предыдущих уведомлений сохранены для проверки истории изменений и источников, но исключены из поиска по умолчанию.

Материалы по разъяснению, оцениванию и исследованиям не имеют той же юридической силы, что и законодательные учебные программы, поэтому они отдельно обозначены как особый тип материалов. Индексируются следующие категории: 26 единиц, входящих в исследование проекта учебной программы специального образования 2022 года, проведённое Национальным институтом специального образования, в части средней/старшей школы; отчёт о расследовании и проверке национальной учебной программы специального образования за 2025 год; руководство по оцениванию и материалы по оцениванию базовой учебной программы; материалы по уровням достижений для старшей школы за 2026 год; материалы по уровням достижений в области сайта здравоохранения и профессионального обучения, а также по гарантии минимального уровня достижений. Материалы с доступом для членов Edunet обрабатываются локально только при наличии исходников и не хранятся в Git. Известные пробелы в рамках определённого специального набора дополнительных материалов для специального образования могут быть проверены в get_coverage_report как 0.

Права и уведомление об отсутствии одобрения

Этот проект не является официальным продуктом Министерства образования, Национальной комиссии по образованию или NCIC. Официальные документы подчиняются условиям использования каждого первоисточника, и лицензия MIT этого репозитория не распространяется на официальные документы. Подробности см. в PROVENANCE.md, ACKNOWLEDGEMENTS.md, THIRD_PARTY_NOTICES.md.

О способах отправки сообщений об ошибках и внесения вклада см. в CONTRIBUTING.md, о сообщении о проблемах безопасности — в SECURITY.md.

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
      -