韩国特殊教育课程 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 及采集时间记录

• 使用 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 下载、验证后转换。需要 Edueable 会员访问权限的资料为可选项，目录中的 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 年高中成就水平资料、理疗·职业生活成就水平和最低成就水平保障指导资料。需要 Edueable 会员访问权限的资料仅由用户自行获取的原件在本地处理，不包含在 Git 中。所定义的特殊教育专用补充资料范围的已知缺失可在 get_coverage_report 中确认为 0 件。

权利与未批准声明

本项目不是教育部·国家教育委员会·NCIC 的官方产品。官方文档遵循各原始来源的使用条件，本存储库的 MIT 许可证不适用于官方文档。详细信息请参阅 PROVENANCE.md、ACKNOWLEDGEMENTS.md、THIRD_PARTY_NOTICES.md。

错误报告和改进贡献方法请参阅 CONTRIBUTING.md，安全问题报告请参阅 SECURITY.md。