korean-secondary-learning-map-mcp

Name: korean-secondary-learning-map-mcp
Author: raphysicst-create

本地服务

github.com/raphysicst-create科研与教育269 周前更新

代码仓库

关于 korean-secondary-learning-map-mcp

korean-secondary-learning-map-mcp 是用于查询韩国 2022 年修订版初高中课程的 MCP 服务。它帮助教育类 AI 客户端检索官方成就标准、主题、先修关系及初高中衔接，并仅收录有来源依据的关系。

主要功能

01搜索课程、标准和主题
02获取官方标准全文
03查询先修与后续关系
04查看学科路线图和学习集群
05追踪初高中主题衔接
06查询高中课程路径

适用场景

01按代码或关键词查找标准
02查看标准对应的官方全文
03探索主题的先修路径
04追踪初高中之间的主题衔接

MCP 相关

向 MCP 客户端提供 11 种课程搜索和查询工具，涵盖标准、主题、学习关系、路线图和课程路径。数据包含初中及普通或特殊目的高中科目，不包含职业高中专业科目。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "raphysicst-create-korean-secondary-learning-map": {
      "command": "npx",
      "args": [
        "-y",
        "korean-secondary-learning-map-mcp"
      ]
    }
  }
}

启动命令npx -y korean-secondary-learning-map-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmkorean-secondary-learning-map-mcp0.3.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
schoolLevel	enum	否	学段筛选器middle \| high
subjectGroup	string	否	学科（群）名称（例如：科学、社会（含历史））

详细介绍

korean-secondary-learning-map-mcp

这是一个 MCP（Model Context Protocol）服务，可让 AI 查询韩国中学（初中、高中普通课程、特殊目的高中课程[科学·艺术·体育]）2022 修订课程的学习图谱。 只需在 Claude Desktop、Claude Code 等支持 MCP 的 AI 客户端中通过一行配置连接，AI 就能直接搜索学习成就标准、学习主题、先修关系和初中→高中衔接内容，并据此回答。

数据规模

项目	数量
课程（教育课程）	255（初中 24 · 高中 231）
学习成就标准	3,838（初中 714 · 高中 3,124）
学习成就标准原文	3,838（自动提取 3,824 + 公式手动修正 14）
细分学习主题	5,284
先修关系（学科内）	266（初中 56 · 高中 210）
学习集群	838
初中→高中衔接	175
课程关系（高中课程间的先后关系）	39

构建时舍弃的项目：

高中先修关系中，DECK6 原始数据的 508 条里有 298 条因排除职业高中特殊专业课程而被舍弃，因此仅包含 210 条（加上初中 56 条，共 266 条）。
初中→高中衔接相比原始数据舍弃 0 条（175 条全部包含）。
课程关系的原始数据 39 条均在包含范围内，未舍弃任何数据，全部纳入。

范围与局限

不包含职业高中特殊专业课程（47,625 条）。 本服务涵盖全部初中课程，以及高中普通课程（共同·一般选修·生涯选修·融合选修）和特殊目的高中课程（科学·艺术·体育，964 条）。不过，「戏剧」课程（13 条）在 DECK6 分类中属于艺术类，但实际上收录于附册 4（普通课程），因此在扩展纳入特殊目的高中课程之前就已包含。
11 个代码（12스문·12심독 系列）由两个不同的课程共用——需在 get_standard 中通过 subject 参数区分。
先修关系、衔接关系和课程关系只收录官方文件（附册 3·附册 4·附册 20·附册 21·附册 22，依据 DECK6）直接支持的关系。与小学版本相比，先修关系数量相对较少，并非数据不完整，而是因为排除了缺乏依据的推测性关系。
先修关系、衔接关系和课程关系是模型推荐的结构，并非对普遍学习顺序的主张。

11 种工具

6 种搜索和列表类工具（list_curricula、search_standards、search_topics、search_standard_text、get_learning_roadmap、list_clusters）支持 schoolLevel（middle | high）筛选。其余 5 种（get_standard、get_topic、get_prerequisites、get_transitions、get_course_pathway）按 ID 或代码查询单条记录，不提供筛选器。

工具	说明
`list_curricula`	未指定筛选器时，汇总学校级别和学科组；指定 `schoolLevel`/`subjectGroup` 时，返回课程列表
`search_standards`	按代码、关键词和筛选条件搜索学习成就标准（摘要列表）
`search_standard_text`	在学习成就标准的官方原文全文中搜索关键词（匹配片段）
`get_standard`	按学习成就标准代码查询完整记录、官方原文和关联主题。对于代码共用课程，通过 `subject` 区分
`search_topics`	搜索细分学习主题（摘要列表）
`get_topic`	按主题 ID 查询完整记录，包括观察证据、评估题目和来源
`get_prerequisites`	查询主题的先修/后续关系。若 `depth: "all"`，则返回按拓扑排序的传递性学习路径
`get_learning_roadmap`	按领域→集群层级汇总课程的学习成就标准，生成路线图
`list_clusters`	查询学习集群列表和详情
`get_transitions`	按主题 ID 或学习成就标准代码双向查询初中→高中衔接（深化关联）
`get_course_pathway`	按课程名称查询高中课程间建议的先后顺序（例如：英语Ⅰ→英语Ⅱ）

安装

Claude Code

claude mcp add curriculum-kr-secondary -- npx -y korean-secondary-learning-map-mcp

若要在所有项目中使用，请设置为用户范围：

claude mcp add -s user curriculum-kr-secondary -- npx -y korean-secondary-learning-map-mcp

Claude Desktop

将配置添加到设置文件中。 macOS：~/Library/Application Support/Claude/claude_desktop_config.json · Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "curriculum-kr-secondary": {
      "command": "npx",
      "args": ["-y", "korean-secondary-learning-map-mcp"]
    }
  }
}

保存后重启 Claude Desktop，即会加载 11 种工具。

要求

Node.js ≥ 20.11（包含 npx）

本地开发

git clone https://github.com/raphysicst-create/korean-secondary-learning-map-mcp.git
cd korean-secondary-learning-map-mcp
npm install
npm test          # node --test tests/*.test.mjs

data/kr/ 中的数据已提交，因此一般使用时无需重现处理流水线。若要重建数据，请按以下顺序运行。

npm run pipeline:fetch     # DECK6 원본 + NCIC PDF 7권 확보·해시 검증 (.cache/, git 미추적)
npm run pipeline:build     # DECK6 원본에서 범위 필터링해 data/kr/*.json 생성
npm run pipeline:extract   # PDF에서 성취기준 원문 추출 (실패분은 pipeline/exceptions.json으로 수동 보정)
npm run pipeline:verify    # 전수 검증(수량 게이트·참조 무결성) + manifest.json 해시 기록

7 册 PDF（附册 3、附册 4 Ⅰ·Ⅱ·Ⅲ、附册 20·21·22）必须位于仓库之外，并从 PDF_DIR 环境变量（默认值：仓库的父文件夹）指定的位置查找。

法律声明

MIT——保留基础数据集（学习主题·先修关系·集群·衔接关系·课程关系）原作者 DECK6 的版权声明（固定提交 68e6228）。
学习成就标准原文作为教育部·国家教育委员会公告的附册，根据《著作权法》第 7 条第 2 项不受保护。为确保准确性和可追溯性，我们标注了官方来源——详情见 NOTICE.md
所收录原文所依据的公告——附册 3·4·20·21 依据教育部公告第 2022-33 号，附册 22 依据国家教育委员会公告第 2024-3 号。修订附册 3·4 的国家教育委员会公告第 2026-1 号（2026.1.21.）修订内容尚未纳入。
本项目并非教育部·国家教育委员会·NCIC 的官方成果，也不对个别学习者进行诊断。