Korean Elementary Learning Map MCP server

korean-elementary-learning-map-mcp

한국 초등 2022 개정 교육과정 학습 그래프를 AI가 조회하게 해주는 MCP(Model Context Protocol) 서버입니다. Claude Desktop, Claude Code 등 MCP를 지원하는 AI 클라이언트에 설정 한 줄로 연결하면, AI가 성취기준·학습 주제·선수관계를 직접 검색해서 답합니다.

특징

• 성취기준 공식 원문 수록 — 620개 전부 NCIC 공개 PDF에서 추출·전수 검증. 원문 전문 검색 도구 제공
• 완전 로컬 동작 — 데이터가 패키지에 내장(약 8.6MB)되어 설치 후 네트워크 불필요, stdio 방식
• 무결성 보장 — 데이터 파일별 SHA-256을 서버 기동 시 재검증. 손상된 설치본은 기동 거부
• LLM 친화 설계 — 검색은 요약만, 상세는 조회로 나눈 2단계 패턴(토큰 절약). 오타 입력엔 유사 후보 제안

빠른 시작

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

설치 후 AI에게 바로 물어보세요:

"3-4학년 수학에서 분수 관련 성취기준 찾아줘"

"[2수01-01] 원문 보여줘"

"초등 1-2학년 수학 한 학기 로드맵 정리해줘"

설치

Claude Code

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

모든 프로젝트에서 쓰려면 사용자 범위로:

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

Claude Desktop

설정 파일에 추가합니다. macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json · Windows: %APPDATA%\Claude\claudedesktopconfig.json

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

저장 후 Claude Desktop을 재시작하면 도구 9종이 로드됩니다.

Codex CLI

codex mcp add curriculum-kr -- npx -y korean-elementary-learning-map-mcp

또는 ~/.codex/config.toml에 직접 추가:

[mcp_servers.curriculum-kr]
command = "npx"
args = ["-y", "korean-elementary-learning-map-mcp"]

기타 MCP 클라이언트 (Cursor 등)

stdio 방식 MCP 서버를 지원하는 모든 클라이언트에서 동일한 형태로 등록됩니다: 실행 명령 npx, 인자 ["-y", "korean-elementary-learning-map-mcp"].

요구 사항

• Node.js ≥ 20.11 (npx 포함)
• 첫 실행 시 npm에서 패키지를 내려받으며(약 320KB 압축), 이후에는 캐시로 즉시 실행됩니다

동작 확인

printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"smoke","version":"0.0.0"}}}' | npx -y korean-elementary-learning-map-mcp | head -1

"serverInfo":{"name":"korean-elementary-learning-map","version":"0.5.2"}가 포함된 응답이 나오면 정상입니다.

프로그램 API

서버 애플리케이션이나 빌드 파이프라인에서는 stdio 자식 프로세스 없이 같은 검증 데이터를 직접 읽을 수 있습니다.

import { createLearningMap } from 'korean-elementary-learning-map-mcp';

const learningMap = createLearningMap();
const standard = learningMap.getStandard('2수01-01');
const topics = learningMap.searchTopics({ standardCode: '2수01-01' });

프로그램 API는 읽기 전용이며 MCP 서버와 동일하게 기동 시 데이터 파일의 SHA-256을 검증합니다.

사용법

AI에게 자연어로 물어보면 알아서 적절한 도구를 호출합니다. 대표 시나리오:

도구 레퍼런스 (9종)

list_curricula

11개 교과의 ID·이름·성취기준 수·학년군·영역 목록. 파라미터 없음.

search_standards

성취기준 검색 — 코드 정확 일치 우선, 이후 키워드 부분 일치 랭킹.

Shortened. The full README is on GitHub.