MCP del Currículo de Educación Especial de Corea

Servidor MCP de solo lectura que explora, con sus fuentes, los currículos básico, común y centrado en opciones de la escuela secundaria y la preparatoria del Currículo de Educación Especial revisado de 2022 de la República de Corea.

La versión actual es v0.1.0-candidate. No distribuye el texto oficial original en el repositorio, sino que reproduce un corpus de búsqueda local vinculado a avisos oficiales, volúmenes separados, hashes de archivo y ubicaciones de página.

Inicio rápido

Los requisitos son Git y Node.js 20 o superior. Tras clonar el repositorio, ejecute el siguiente comando.

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 descarga y estructura automáticamente los materiales disponibles en URL públicas. Si faltan los materiales complementarios opcionales que requieren inicio de sesión en la institución publicadora, solo muestra una advertencia y continúa preparando el resto de los materiales. El alcance real disponible para el servidor y los materiales faltantes se verifican con get_coverage_report.

Las instrucciones de conexión por sistema operativo y ejemplos para quienes instalan por primera vez están en docs/USER_GUIDE.md.

Alcance

• Escuela secundaria y preparatoria

• Currículo básico

• Currículo común

• Currículo centrado en opciones

• Aviso oficial n.º 2022-34 del Ministerio de Educación y avisos de revisión posteriores

La fecha de referencia vigente es el 19 de agosto de 2026, y el aviso oficial n.º 2026-2 de la Comisión Nacional de Educación se toma como línea base de la educación especial. También se recopila el aviso n.º 2024-3 para verificar la relación de aplicación de las asignaturas generales de los currículos común y centrado en opciones.

Implementación actual

• 81 fuentes oficiales preparadas: 35 currículos legales, 1 explicación, 17 materiales de evaluación, 28 materiales de investigación y verificación

• 29 documentos legales vigentes: volúmenes separados 1, 2 y 3 de educación especial y 26 volúmenes separados del currículo general aplicables por analogía a secundaria y preparatoria

• Verificación de firma de archivo, SHA-256, URL final y registro de hora de recopilación

• Conversión de HWP/HWPX/PDF a Markdown y fragmentos estructurados mediante kordoc

• Corpus de búsqueda local de 26 354 páginas y 112 889 fragmentos

• Filtros de escuela secundaria, preparatoria y currículos básico, común y centrado en opciones

• Filtro materialKind que separa textos legales, explicaciones, logros/evaluación y materiales de investigación

• MCP STDIO de solo lectura que incluye URL de fuente, número de aviso oficial, número de página y ruta de índice

Desarrollo

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

Los resultados de descarga y extracción de documentos oficiales están en .gitignore. La información de reproducibilidad se registra en sources/official/source-receipts.json.

No es necesario descargar por separado el currículo legal ni los materiales complementarios públicos. npm run sources:prepare los descarga desde las URL oficiales, los verifica y los convierte. Los materiales de acceso para miembros de EduAble son opcionales; en el catálogo, manualAcquisition registra el nombre de archivo original y la ruta interna del ZIP. Si se obtienen esos originales directamente y se colocan en sources/official/files/ con el nombre de archivo en inglés especificado, se incluyen en el corpus completo. Si faltan, el recopilador muestra los archivos necesarios y los nombres de destino, y continúa procesando el resto de los materiales que se pueden recopilar automáticamente.

Para verificar estrictamente si todos los materiales están preparados localmente, ejecute el siguiente comando.

npm run check:full

Herramientas MCP

• list_official_sources: línea base vigente, fuentes, estado de preparación y número de fragmentos

• get_coverage_report: estado de preparación y omisión de los textos legales vigentes y materiales complementarios

• search_curriculum: búsqueda con filtros de término, nivel escolar, tipo de currículo, asignatura y tipo de material

• get_curriculum_chunk: consulta del contexto y la ubicación del texto original de los resultados de búsqueda

• find_achievement_standard: búsqueda por código de estándar de logro

Conexión MCP

Se ejecuta como servidor STDIO local. Tras la compilación, use el siguiente comando en .codex/config.toml del ámbito del proyecto o en la configuración MCP de Codex.

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

Un ejemplo de configuración de proyecto de Codex es el siguiente.

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

Antes de conectar el servidor, ejecute npm run sources:prepare y npm run build una vez.

Tras la conexión, se recomienda verificar primero el alcance con una solicitud como la siguiente.

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

Ejemplos de preguntas posteriores:

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

Alcance de interpretación de datos

Se incluyen todos los volúmenes separados 3, 4, 7, 12, 14, 18, 19, 22, 23~39 y 41, que son el ámbito de secundaria y preparatoria entre los currículos generales que el volumen separado 2 del aviso oficial n.º 2026-2 de la Comisión Nacional de Educación aplica por analogía. Los 29 textos legales vigentes reciben una verificación de integridad independiente en get_coverage_report. Los 6 avisos anteriores se conservan para verificar el historial de cambios y las fuentes, pero se excluyen de la búsqueda básica.

Los materiales de explicación, evaluación e investigación no tienen el mismo efecto que el currículo legal, por lo que se marcan como un tipo de material aparte. Se indexan 26 estudios de propuesta de currículo de educación especial de 2022 del Instituto Nacional de Educación Especial en el ámbito de secundaria y preparatoria, el informe de investigación y verificación de educación especial del currículo nacional de 2025, las guías de evaluación y los materiales de evaluación del currículo básico, los materiales de nivel de logro de preparatoria de 2026, y los materiales de nivel de logro y de orientación para garantizar el nivel mínimo de logro de terapia física y vida laboral. Los materiales de acceso para miembros de EduAble solo se procesan localmente si el usuario obtiene los originales directamente y no se incluyen en Git. Las omisiones conocidas dentro del alcance definido de materiales complementarios exclusivos de educación especial se pueden confirmar como 0 en get_coverage_report.

Aviso de derechos y no respaldo

Este proyecto no es un producto oficial del Ministerio de Educación, la Comisión Nacional de Educación ni NCIC. Los documentos oficiales siguen las condiciones de uso de cada fuente original, y la licencia MIT de este repositorio no se aplica a los documentos oficiales. Para más detalles, consulte PROVENANCE.md, ACKNOWLEDGEMENTS.md y THIRD_PARTY_NOTICES.md.

Para informar errores y contribuir mejoras, consulte CONTRIBUTING.md; para reportar problemas de seguridad, consulte SECURITY.md.