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.

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

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

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

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

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

• Уведомление Министерства образования № 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.