1 v0.3.1 更新于 2026-10-23

Somtoday (unofficial) MCP Server

Unofficial read-only Somtoday parent portal: timetable, homework, grades, assignments, messages

适用客户端

本地客户端
Claude Desktop、Claude Code、Cursor、Cline 等支持本地 MCP 的客户端

安装配置

本地运行(npm)
{
  "mcpServers": {
    "somtoday-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "somtoday-mcp"
      ]
    }
  }
}

将上方 JSON 加入 MCP 客户端配置(如 Claude Desktop 的 claude_desktop_config.json 或项目的 .mcp.json)即可接入;远程接入按客户端要求填写 URL 与鉴权头。

提供的工具 接入后 Agent 可调用这 20 个工具

whoami
返回学校标签、关联子女及其数字 ID,以及可见的门户板块。
lessons
获取某一天的课表,含是否为假期、课程类型和取消信息。
homework
获取日期范围内的学习计划任务,按天分组,含描述、学习目标、时间估计、测试类型、附件等。
grades
获取最近的成绩(最多30条)及各科平均分。
assignments
获取所有提交作业及其时间窗口、状态、逾期标记、描述、附件和链接。
assignment_detail
查看单个作业的详情:说明、文件、链接、提交窗口和状态。
study_material
获取各科学习材料:按日期的课程材料、按文件夹的年度附件、外部链接和教辅链接。
schedule
获取日期范围内的课表:时间、节次、科目、教室、教师、类型、备注、变动和假期。
grades_latest
按最新排序获取成绩,含科目、描述、分数、权重、测试类型等,可指定数量和档案类型。
grades_overview
获取某学年的完整成绩概览:所有科目、各时段成绩、报告分数、权重和备注。
subject_grades
获取单个科目的所有成绩信息:结果列、权重、备注、列定义及综合测试部分。
exam_grades
获取学校考试档案(PTA/SE):各科 SE 平均分、所有 SE 成绩、待考测试及测试类型平均分。
absence
获取学年或评估期的缺勤与登记记录(缺席、迟到、移除等)及活跃措施。
messages
只读查看消息:最新会话列表或通过会话 ID 查看完整线程,不会标记为已读。
news
获取学校新闻条目(按最新排序)及未读数量。
announcements
获取门户中显示的 Somtoday 全平台公告。
children
获取关联子女的资料、班级、学校数据、当前安置及可见门户板块。
school_info
获取学校联系信息和学校信息页面,可按页面 ID 打开单个页面。
teachers
获取可发消息的教职员工及其教授子女的科目。
signing_requests
只读查看数字签名请求(不做任何签名操作)。