课程框架API服务

为芬兰国家教育机构的课程和资格框架提供API服务,支持教育官员、学校校长和课程规划者查询、比较和验证国家和地方课程文档。

  • by OJHela
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 OJHela/eperusteet-mcp

使用说明

电子基础 MCP

芬兰国家教育局(OPH)API课程和资格框架的MCP服务器。

它的作用

让市政教育官员、学校校长和课程规划者立即查询、比较和验证国家课程框架和职业地方课程文件。

数据来源: https://eperusteet.opintopolku.fi 身份验证: 无需 语言: 芬兰语

工具

工具 说明
hae_perusteet 按名称和/或教育类型搜索国家课程框架
hae_peruste_tiedot 通过ID获取国家框架的完整结构化内容
hae_oppiaineet 在lukio(lops2019)框架中列出所有主题
hae_paikalliset_opetussuunnitelmat 列出当地职业课程实施情况
hae_paikallinen_opetussuunnitelma 获取特定当地课程计划的全部内容

示例问题

  • 2014年OPS基础数学课程的7-9年级目标是什么?
  • “2019年高中OPS基础要求哪些必修课程?”
  • “坦佩雷市是否发布了当地基础教育OPS?”
  • “列出赫尔辛基高中的当地课程。”

已知教育类型代码

代码 类型
koulutustyyppi_16 Perusopetus(基础教育)
koulutustyyppi_2 高中(Upper Secondary)
koulutustyyppi_1 职业学位(Vocational)
koulutustyyppi_11 专业学位
koulutustyyppi_12 专业特殊学位。
koulutustyyppi_10 自由成人教育(Liberal Adult Education)
koulutustyyppi_22 TUVA(学位培训)
koulutustyyppi_0 Varhaiskasvatus(幼儿教育)

已知ID

ID 框架
419550 OPS基础教育2014
6828810 2019年高中OPS基础知识
1372910 高中OPS基础知识 2015

本地开发

python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
python3 test_tools.py      # must exit 0
uvicorn server:app --port 8000
curl http://localhost:8000/health  # → OK

连接到Intric

  1. 部署到铁路(请参阅Procfile)
  2. 网址: https://{your-domain}.railway.app/mcp
  3. 无需令牌(无身份验证服务器)

备注

  • eperusteet-ylops 服务 /external/opetussuunnitelmat 列表端点有效(1241+个文档)。每个ID的详细信息端点(/{id})返回500——工具仅返回列表级元数据,并将用户引导到web UI以获取完整内容。
  • 服务器端过滤器 koulutustyyppi, kunta, perusteId 被ylops API忽略- koulutustyyppi 在工具的客户端应用。
  • 当地职业OPS(ammatilliset)位于单独的 草莓 服务 --不在此服务器覆盖范围内。
  • 完整的阅读回复可以是9MB——工具提取结构化摘要。