Skip to main content
Glama
Education Scope MCP
by YAMA-TANA

EDUCATION_SCOPE_MCP

日本の学校教育で、ある知識・用語・解法がどの学校段階・学年・教科の範囲かを判定し、LLMの説明が指定学年を超えていないか監査するMCPサーバーです。

文部科学省の学習指導要領コード表(小学校 82V12 / 中学校 83V11 / 高等学校 84V10)を取得・正規化して検索でき、手作業seedは自然な別名と前提知識グラフの補助データとして併用します。

MCP Registry

  • Registry name: io.github.YAMA-TANA/education-scope-mcp

  • Display name: Education Scope MCP

  • Version: 0.2.0

  • OCI image: ghcr.io/yama-tana/education-scope-mcp:0.2.0

  • Transport: stdio

Registry description:

Classify Japanese school curriculum scope, audit explanations against grade limits, and search 16,887 normalized MEXT curriculum-code entries.

server.json はOfficial MCP Registry向けのmanifestです。.github/workflows/publish-mcp.yml がOCIイメージをGHCRへ公開し、GitHub Actions OIDCでRegistryへ送信します。追加のRegistry用シークレットは不要です。

Related MCP server: BNCC MCP Server

MCP tools

  • classify_knowledge_scope — 「三平方の定理」「微分」「現在完了」などの教育範囲を判定

  • check_answer_scope — 「中2までで説明して」に高校・中3範囲が混ざっていないか監査

  • search_curriculum — 学校段階・教科・領域・キーワードで公式コード表を検索

  • get_prerequisites — そのトピックを理解するための前提知識を取得

  • list_supported_scopes — 監査に指定できる上限学年を取得

  • get_dataset_status — 全量MEXTデータがロード済みか、コード表別件数とともに確認

例

classify_knowledge_scope("三平方の定理")

{
  "bestMatch": {
    "stage": "中学校",
    "grade": 3,
    "subject": "数学",
    "topic": "三平方の定理"
  }
}

check_answer_scope("三平方の定理を使います。", "中2")

{
  "withinTarget": false,
  "exceedsTarget": [
    {
      "stage": "中学校",
      "grade": 3,
      "topic": "三平方の定理"
    }
  ]
}

セットアップ

Node.js 20以上。

npm install
npm test

stdio MCP

npm run build
npm start

MCPクライアント設定例:

{
  "mcpServers": {
    "education-scope": {
      "command": "node",
      "args": ["/absolute/path/EDUCATION_SCOPE_MCP/dist/src/index.js"]
    }
  }
}

Docker / OCI

docker run --rm -i ghcr.io/yama-tana/education-scope-mcp:0.2.0

Remote HTTP MCP

npm run build
PORT=3000 npm run start:http
  • MCP endpoint: http://localhost:3000/mcp

  • health check: http://localhost:3000/health

HTTP実装はMCP TypeScript SDK v2の createMcpHandler を使用しています。

文科省データを全量取り込む

npm run import:mext

このコマンドは3つの公式CSVを取得し、raw保存だけでなくMCPが直接読める正規化済みデータまで生成します。

data/mext/raw/
  elementary-82V12.json
  junior-high-83V11.json
  high-school-84V10.json
  index.json

data/mext/normalized/
  curriculum-items.json
  summary.json

curriculum-items.json が存在すれば、MCP起動時に自動で読み込みます。存在しない環境でもseed-onlyモードで起動できます。現在どちらのモードかは get_dataset_status で確認できます。

公式コード表から保持する主な情報:

{
  stage,
  grade,
  grades,
  subject,
  course,
  domain,
  topic,
  aliases,
  curriculumCode,
  codeTable,
  itemNumber,
  sectionPath,
  source
}

学年は16桁の学習指導要領コードの学年・段階欄を解釈します。複数学年にまたがるコードは grades に全学年を保持し、学年上限監査では安全側に倒すため、その範囲の上端を grade として使用します。高等学校は学年を推測して付与しません。

自動更新

.github/workflows/refresh-mext.yml は文科省CSVを取得し、正規化・テスト・件数検証を通過した場合だけ data/mext/normalized/ をmainへコミットします。毎月1日の定期更新と手動実行に対応しています。

raw CSV由来JSONはGit管理対象外で、MCPが必要とする正規化済みJSONだけをリポジトリに保持します。

判定設計

公式コード表は「何を扱うか」の一次根拠として優先し、src/data.ts のseedは次の補助用途に残しています。

  • 「三平方」「ピタゴラスの定理」のような自然なalias

  • 概念間の前提知識グラフ

  • 公式データをまだ生成していない環境のフォールバック

check_answer_scope は未登録概念を自動的に「範囲内」とは判定しません。既知概念を1件も検出できない文章は unknownTextPresent: true として安全側に倒します。

データソース

文部科学省「教育データ標準」学習指導要領コード表:

License

MIT

Available Tools

6 tools
check_answer_scopeA

説明文や解答に、指定した学年より後で学ぶ既知概念が混ざっていないか監査します。『中2までで説明して』のような制約チェック向けです。未登録概念は安全判定せず未判定にします。

Inputs: answer (required), target (required).

classify_knowledge_scopeC

日本の学校教育において、指定した知識・用語・解法が主にどの学校段階・学年・教科で扱われるかを判定します。文部科学省の正規化済み学習指導要領コード表が利用可能な場合はそれを優先します。

Inputs: query (required), limit.

get_dataset_statusA

文部科学省の正規化済み全量データがロードされているか、コード表ごとの件数とともに返します。

Inputs: no named parameters.

get_prerequisitesB

指定したトピックを理解するための前提知識を返します。公式コード表に概念依存関係がない場合は、同梱seedの前提知識グラフを補助的に使用します。

Inputs: topic (required), depth.

list_supported_scopesA

check_answer_scope で指定できる教育範囲の上限一覧を返します。

Inputs: no named parameters.

search_curriculumB

教育範囲データから、教科・学校段階・領域・キーワードで項目を検索します。公式データでは学習指導要領コードも結果に含まれます。

Inputs: limit, query, stage, domain, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 6 tools

    Disambiguation4/5

    Each tool has a fairly distinct role: classify_knowledge_scope grades a single term, check_answer_scope audits text against a grade limit, and search_curriculum queries the data. There is mild overlap between classify_knowledge_scope and search_curriculum (both can surface grade/subject for a term), but the descriptions differentiate input and output clearly.

    Naming Consistency5/5

    All six tools use a consistent snake_case verb_noun pattern (classify_/check_/search_/get_/list_/get_), with clear action verbs and noun objects. No mixed conventions or vague names.

    Tool Count5/5

    Six tools is well-scoped for a curriculum-scope lookup domain. Each tool earns its place: two core lookups, one audit, one prerequisite graph, and two meta/status helpers.

    Completeness4/5

    The surface covers the key lifecycle: classifying scope, auditing text, searching curriculum, prerequisites, and data-status checks. Minor gaps exist (e.g., no explicit tool to list all subjects/grade progression beyond search), but core agent workflows are supported.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables natural-language querying of the British Columbia K-12 curriculum, including Big Ideas, Curricular Competencies, Content standards, grade progressions, and cross-subject connections, grounded in official BC Ministry of Education data.
      8
      48 npm
      MIT