Education Scope MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Education Scope MCP 三平方の定理を使う説明は中2までで大丈夫?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
EDUCATION_SCOPE_MCP
日本の学校教育で、ある知識・用語・解法がどの学校段階・学年・教科の範囲かを判定し、LLMの説明が指定学年を超えていないか監査するMCPサーバーです。
文部科学省の学習指導要領コード表(小学校 82V12 / 中学校 83V11 / 高等学校 84V10)を取得・正規化して検索でき、手作業seedは自然な別名と前提知識グラフの補助データとして併用します。
MCP Registry
Registry name:
io.github.YAMA-TANA/education-scope-mcpDisplay name: Education Scope MCP
Version:
0.2.0OCI image:
ghcr.io/yama-tana/education-scope-mcp:0.2.0Transport:
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 teststdio MCP
npm run build
npm startMCPクライアント設定例:
{
"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.0Remote HTTP MCP
npm run build
PORT=3000 npm run start:httpMCP endpoint:
http://localhost:3000/mcphealth 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.jsoncurriculum-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 として安全側に倒します。
データソース
文部科学省「教育データ標準」学習指導要領コード表:
小学校
82V12中学校
83V11高等学校
84V10
License
MIT
Available Tools
6 toolscheck_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
Scored across 6 tools
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.
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.
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.
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
Query the full BC K-12 curriculum: Big Ideas, Competencies, Content, and more.
Authoritative JLPT-graded Japanese dataset (kanji, vocab, grammar, history) via MCP and REST.
Create structured courses, lessons, and educational images for any topic, level, and language.
Map prerequisites, track mastery and recommend the next topic each learner is ready for.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceExposes Marble's open skill taxonomy (ages 4-15) as queryable MCP tools, enabling AI agents to search topics, find prerequisites, and plan learning paths.1MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to query and validate BNCC (Brazilian curriculum) skills deterministically, preventing hallucinations by providing official data, search, and code validation tools.-
- AlicenseNot gradedqualityCmaintenanceProvides access to the Korean elementary 2022 revised curriculum learning graph, enabling users to search and retrieve curriculum standards, learning topics, prerequisites, and roadmaps from a fully local database.117 npm16MIT
- AlicenseAqualityDmaintenanceEnables 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.848 npmMIT