韓国特殊教育カリキュラム MCP

大韓民国2022年改訂特殊教育カリキュラムのうち、中学校・高等学校の基本・共通・選択中心 カリキュラムを出典とともに探索する読み取り専用MCPサーバーである。

現在のバージョンは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で確認する。

初めてインストールするユーザー向けのOS別接続方法と例は 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および収集時刻の記録

• kordocを用いたHWP/HWPX/PDF → Markdown・構造チャンク変換

• 26,354ページ、112,889個のチャンクからなるローカル検索コーパス

• 中学校・高等学校および基本・共通・選択中心フィルター

• 法定原文・解説・成就/評価・研究資料を分離するmaterialKindフィルター

• 出典URL・告示番号・ページ数・目次パスを含む読み取り専用STDIO MCP

開発

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からダウンロードし、検証した後に変換する。エデュエイブル会員アクセス資料は任意であり、カタログの 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または Codex MCP設定で次のコマンドを使用する。

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]의 원문과 성취기준 해설을 구분해서 보여줘.
진로와 직업 과목에서 안전과 관련된 내용을 고시 원문만 대상으로 검색해줘.

データ解釈範囲

国家教育委員会告示第2026-2号別冊2が準用する一般教育課程のうち、中・高等学校 範囲である別冊3・4・7・12・14・18・19・22・23〜39・41をすべて含む。現行法定原文29件は get_coverage_reportで独立的に完全性検査を受ける。以前の告示6件は変更履歴と 出典確認用に保存するが、基本検索では除外する。

解説・評価・研究資料は法定教育課程と同じ効力を持つ文書ではないため、別途資料種類として 表示する。国立特殊教育院の2022年特殊教育教育課程試案研究のうち中・高等学校範囲26種、 2025年国家教育課程特殊教育調査・点検報告書、評価ガイドと基本教育課程評価資料、 2026年高等学校成就水準資料、理療・職業生活成就水準と最小成就水準保障指導資料まで 索引する。エデュエイブル会員アクセス資料はユーザーが直接確保した原本のみローカルで処理し、Gitには 含めない。定義した特殊教育専用補足資料範囲の既知の欠落は get_coverage_reportで0件と確認できる。

権利と非承認の告知

このプロジェクトは教育部・国家教育委員会・NCICの公式製品ではない。公式文書は各 元出典の利用条件に従い、このリポジトリのMITライセンスが公式文書に適用されるものでは ない。詳細はPROVENANCE.md、ACKNOWLEDGEMENTS.md、 THIRD_PARTY_NOTICES.mdを参照する。

エラー報告と改善への貢献方法はCONTRIBUTING.md、セキュリティ問題の報告は SECURITY.mdを参照する。