MCP für den südkoreanischen Sonderpädagogik-Lehrplan

Ein schreibgeschützter MCP-Server zur Erkundung des Lehrplans für Sonderpädagogik der Republik Korea (Revisionsstand 2022) für Mittel- und Oberschulen – mit Fokus auf den grundlegenden, gemeinsamen und wahlorientierten Lehrplan – inklusive Quellenangaben.

Die aktuelle Version ist v0.1.0-candidate. Offizielle Originaltexte werden nicht im Repository veröffentlicht; stattdessen wird ein lokaler Suchkorpus reproduziert, der mit amtlichen Bekanntmachungen, Sonderheften, Datei-Hashes und Seitenpositionen verknüpft ist.

Schnellstart

Voraussetzungen sind Git und Node.js 20 oder höher. Nach dem Klonen des Repositorys führen Sie die folgenden Befehle aus.

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 lädt automatisch alle über öffentliche URLs verfügbaren Materialien herunter und strukturiert sie. Fehlen optionale Ergänzungsmaterialien, für die eine Anmeldung bei der veröffentlichenden Institution erforderlich ist, wird nur eine Warnung ausgegeben und die Vorbereitung der übrigen Materialien fortgesetzt. Den tatsächlichen Umfang und fehlende Materialien, die der Server nutzen kann, prüfen Sie mit get_coverage_report.

Betriebssystemspezifische Verbindungsmethoden und Beispiele für Erstinstallationen sind in docs/USER_GUIDE.md dokumentiert.

Umfang

• Mittel- und Oberschulen

• Grundlegender Lehrplan

• Gemeinsamer Lehrplan

• Wahlorientierter Lehrplan

• Bildungsministerium-Bekanntmachung Nr. 2022-34 und nachfolgende Änderungsbekanntmachungen

Der aktuelle Stichtag ist der 19.08.2026; die Bekanntmachung der Nationalen Bildungskommission Nr. 2026-2 dient als Basislinie für die Sonderpädagogik. Zusätzlich wird die Bekanntmachung Nr. 2024-3 erfasst, um die Anwendungsbeziehung der allgemeinen Fächer im gemeinsamen und wahlorientierten Lehrplan zu prüfen.

Aktuelle Implementierung

• 81 offizielle Quellen vorbereitet: 35 gesetzliche Lehrpläne, 1 Erläuterung, 17 Bewertungsmaterialien, 28 Forschungs- und Prüfmaterialien

• 29 aktuelle gesetzliche Dokumente: Sonderhefte 1, 2 und 3 der Sonderpädagogik sowie 26 Sonderhefte des allgemeinen Lehrplans, die auf Mittel- und Oberschulen angewendet werden

• Dateisignaturprüfung, SHA-256, Aufzeichnung der endgültigen URL und des Erfassungszeitpunkts

• Konvertierung von HWP/HWPX/PDF in Markdown und strukturierte Chunks mit kordoc

• Lokaler Suchkorpus mit 26.354 Seiten und 112.889 Chunks

• Filter für Mittel-/Oberschule sowie grundlegenden, gemeinsamen und wahlorientierten Lehrplan

• materialKind-Filter zur Trennung von gesetzlichen Originaltexten, Erläuterungen, Leistungs-/Bewertungsmaterialien und Forschungsmaterialien

• Schreibgeschützter STDIO-MCP mit Quell-URLs, Bekanntmachungsnummern, Seitenzahlen und Inhaltsverzeichnispfaden

Entwicklung

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

Offizielle Dokument-Downloads und Extraktionsergebnisse sind in .gitignore ausgenommen. Reproduktionsinformationen werden in sources/official/source-receipts.json festgehalten.

Gesetzliche Lehrpläne und öffentliche Ergänzungsmaterialien müssen nicht separat heruntergeladen werden. npm run sources:prepare lädt sie von offiziellen URLs herunter, validiert und konvertiert sie. Materialien mit Eduable-Mitgliederzugang sind optional; der Katalog dokumentiert unter manualAcquisition den ursprünglichen Dateinamen und den Pfad innerhalb der ZIP-Datei. Wenn Sie die Originale selbst beschaffen und unter den angegebenen englischen Dateinamen in sources/official/files/ ablegen, werden sie in den vollständigen Korpus aufgenommen. Fehlen sie, gibt der Sammler die benötigten Dateien und Zielnamen aus und verarbeitet anschließend die übrigen automatisch sammelbaren Materialien weiter.

Ob lokal alle Materialien vollständig vorbereitet sind, wird mit dem folgenden Befehl streng geprüft.

npm run check:full

MCP-Tools

• list_official_sources: aktuelle Basislinie, Quellen, Vorbereitungsstatus und Chunk-Anzahl

• get_coverage_report: Vorbereitungs- und Fehlstatus der aktuellen gesetzlichen Originaltexte und Ergänzungsmaterialien

• search_curriculum: gefilterte Suche nach Suchbegriff, Schulstufe, Lehrplantyp, Fach und Materialart

• get_curriculum_chunk: Abruf von Originaltextkontext und Position aus Suchergebnissen

• find_achievement_standard: Suche nach Leistungsstandard-Codes

MCP-Verbindung

Wird als lokaler STDIO-Server ausgeführt. Nach dem Build verwenden Sie den folgenden Befehl in der projektweiten .codex/config.toml oder in der Codex-MCP-Konfiguration.

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

Ein Beispiel für die Codex-Projekteinstellung sieht wie folgt aus.

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

Führen Sie vor der Serververbindung einmal npm run sources:prepare und npm run build aus.

Nach der Verbindung empfiehlt es sich, zunächst den Umfang mit einer Anfrage wie der folgenden zu prüfen.

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

Beispiele für anschließende Fragen sind:

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

Dateninterpretationsumfang

Enthalten sind alle allgemeinen Lehrpläne