教育内容API服务

SchoolBuddy MCP是一个基于JSON的MCP服务器,提供课程对齐的教育内容,包括教学大纲映射、历年考题与答案、课程摘要、双语词汇表以及为LLM设计的示例问题。

  • by feijoshow
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 feijoshow/schoolbuddy-mcp

使用说明

SchoolBuddy MCP(可译为“校园伙伴MCP”或根据具体语境调整为更贴切的名称)

一个基于JSON的MCP服务器,提供经过精心整理的课程级上下文信息:课程大纲映射、历年考试问答、简短且符合课程大纲的课程总结、双语词汇表,以及为大型语言模型(LLM)消费格式化的例题。

演示

[现场演示链接] - [短视频GIF]

为何这很重要

SchoolBuddy MCP针对数字资源有限的地区对符合课程标准的教育内容的迫切需求。通过提供结构化、经过验证的教育数据,且以大型语言模型(LLM)易于处理的格式呈现,我们使AI辅导老师能够提供准确且贴近当地需求的教学。

MVP(最有价值球员)特点/功能

  • 获取 /mcp/v1/context获取与课程大纲相匹配的教育资源
  • POST /mcp/v1/feedback 翻译为中文是:“提交至/mcp/v1/反馈” 或者更自然的表达可以是:“向/mcp/v1/反馈接口发送POST请求”。这里,“POST”是HTTP方法,表示提交数据;“/mcp/v1/feedback”是API的路径,表示提交反馈的接口收集教师/学生反馈以改进内容
  • 简单的网页用户界面浏览上下文并测试大型语言模型提示
  • 多语言支持英语+当地语言(奥希瓦姆博语、南非荷兰语等)

API 端点

GET /mcp/v1/context 翻译为中文是:“获取 /mcp/v1/context(上下文信息)”

为特定主题检索教育背景信息。

参数:

  • 主题(字符串):主题名称(例如,“数学”)
  • 等级(编号):年级水平(例如,10)
  • 主题(字符串):主题名称(例如,“quadratic-equations”)
  • lang(字符串):语言代码(例如,“en”)

示例回复:

{
  "meta": {
    "track": "education",
    "subject": "Mathematics",
    "grade": 10,
    "topic": "Quadratic Equations",
    "language": "en",
    "generated_at": "2025-10-13T15:00:00+02:00"
  },
  "curriculum": {
    "learning_outcomes": [
      "Solve quadratic equations by factorization and formula",
      "Interpret discriminant and roots"
    ],
    "source": {
      "name": "Namibia Grade 10 Mathematics Syllabus",
      "url": "https://example.gov.na/grade10/math/syllabus"
    }
  },
  "lesson_summary": [
    {
      "section": "Overview",
      "text": "A quadratic equation is ... (short, 3-4 sentences)"
    },
    {
      "section": "Key formula",
      "text": "ax^2 + bx + c = 0, roots = (-b ± sqrt(b^2-4ac)) / (2a)"
    }
  ],
  "questions": [
    {
      "id": "q1",
      "text": "Solve x^2 - 5x + 6 = 0",
      "difficulty": "easy",
      "answer": "x=2 or x=3"
    },
    {
      "id": "q2",
      "text": "A quadratic has discriminant -3, what does that mean?",
      "difficulty": "medium",
      "answer": "No real roots; complex roots"
    }
  ],
  "glossary": [
    {"term": "discriminant", "en": "b^2 - 4ac", "om": "..." }
  ],
  "references": [
    {"label": "Past Paper 2023", "url": "https://...pdf"}
  ]
}```