Skip to main content
TaskNeo MCP 服务器在四个类别中注册了 12 个工具：认证、班级、任务和提交。服务器连接后，你的 AI 助手可以代表你调用其中任意工具。
所有工具都要求你在相关班级中以 Owner 或 Admin 身份完成认证。会修改数据的工具对你只是 Member 的班级无效。

​
认证

使用你的邮箱和密码完成 TaskNeo 认证。只有当你没有在 MCP 配置中设置 TASKFLOW_MCP_KEY、TASKFLOW_TOKEN 或 TASKFLOW_EMAIL/TASKFLOW_PASSWORD 时，才需要手动调用它 - 服务器会在启动时自动使用这些凭据。参数
​
email
string
required
你的 TaskNeo 账户邮箱地址。
​
password
string
required
你的 TaskNeo 账户密码。
返回值成功时返回确认消息和你的用户资料。
{
  "message": "Login successful",
  "user": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "email": "teacher@school.edu",
    "nickname": "Ms. Chen"
  }
}

​
班级

返回你担任 Owner 或 Admin 的所有班级。个人班级会被排除。请将此响应中的 id 值用作任务和提交工具的 classId 参数。参数该工具不接受参数。返回值班级对象数组。
​
id
string
班级 UUID。在其他工具中将其用作 classId。
​
name
string
班级显示名称。
​
description
string | null
可选班级描述。
​
color
string
分配给班级的十六进制颜色值。
​
myRole
string
你在该班级中的角色：OWNER 或 ADMIN。
​
memberCount
number
班级成员总数。
​
inviteCode
string | null
已生成的班级邀请码（如有）。
​
createdAt
string
班级创建时的 ISO 8601 时间戳。

​
任务

列出班级中的所有任务，包括草稿和已发布任务。每个任务都包含提交统计信息，方便你快速查看有多少学生已提交。参数
​
classId
string
required
要列出任务的班级 UUID。可从 list_my_classes 获取。
返回值带有提交数量的任务摘要对象数组。
获取单个任务的完整详情，包括 Markdown 描述、附件元数据、日期和提交统计。参数
​
taskId
string
required
任务 UUID。可从 list_class_tasks 获取。
返回值包含描述、附件和提交数量的完整任务对象。
在班级中创建一个新的草稿任务。直到你调用 publish_task 之前，学生都看不到该任务。可先使用草稿准备任务，再决定何时通知学生。参数
​
classId
string
required
要在其中创建任务的班级 UUID。
​
title
string
任务标题。若省略，默认为 "Untitled Draft"。
​
description
string
任务描述。支持 Markdown。
​
dueAt
string
ISO 8601 格式的提交截止时间，例如 "2025-06-15T23:59:00Z"。
​
startAt
string
任务生效日期，ISO 8601 格式。必须早于 dueAt。
​
allowLateSubmission
boolean
default:"true"
学生是否可以在截止日期后提交。
返回值创建的任务对象，包括新的 id。
任务会以草稿形式保存，对学生不可见。准备发布时调用 publish_task。
更新现有任务的一个或多个字段。只会修改你提供的字段 - 未提供的字段保持不变。草稿和已发布任务都适用。参数
​
taskId
string
required
要更新的任务 UUID。
​
title
string
新的任务标题。
​
description
string | null
新的 Markdown 描述。设为 null 可清空描述。
​
dueAt
string | null
ISO 8601 格式的新截止日期。设为 null 可移除截止日期。
​
startAt
string | null
ISO 8601 格式的新开始日期。设为 null 可移除开始日期。
​
allowLateSubmission
boolean
是否允许迟交。
返回值更新后的任务对象。
Publishes a draft task, making it immediately visible to all class members. Students receive a notification when a task is published.参数
​
taskId
string
required
要发布的草稿任务 UUID。
​
title
string
在发布时覆盖标题。
​
description
string | null
在发布时覆盖描述。
​
dueAt
string | null
在发布时设置或覆盖截止日期。
​
startAt
string | null
在发布时设置或覆盖开始日期。若两者都设置，开始日期必须早于 dueAt。
​
allowLateSubmission
boolean
是否允许迟交。
返回值已发布的任务对象。
发布会立即通知所有学生，且无法撤销。你的 AI 助手应先展示完整任务详情 - 标题、描述、开始日期和截止日期 - 并在调用此工具前向你确认。
删除任务。具体行为取决于是否存在提交：
  • No submissions — the task is permanently deleted.
  • Has submissions — the task is soft-deleted (hidden from students) but submission records are preserved.
参数
​
taskId
string
required
要删除的任务 UUID。
返回值
{ "success": true }
该操作具有破坏性。没有提交的任务在删除后无法恢复。

​
提交

列出某个任务的所有班级成员及其提交状态。你可以通过筛选结果聚焦特定群组 - 例如在批量批改时只看未评分提交。参数
​
taskId
string
required
要列出提交的任务 UUID。
​
filter
string
default:"all"
缩小结果范围。可接受的值：
ValueReturns
all所有班级成员，不论提交状态
submitted已提交的成员
unsubmitted尚未提交的成员
ungraded已提交但尚未评分
graded已设置分数的提交
exemplary被标记为示例的提交（用于评分参考）
Returns行数组，每位班级成员一行。每行包含：
​
userId
string
学生 UUID。
​
email
string
学生邮箱地址。
​
nickname
string | null
学生显示名。
​
submitted
boolean
学生是否已提交。
​
submission
object | null
若学生已提交则存在。包含 id、score、reviewNote、isExemplary、firstSubmittedAt 和 lastUpdatedAt。列表视图不包含提交正文 - 请使用 get_submission 读取。
对于 AI 辅助批改，请调用此工具两次：先用 filter: "exemplary" 获取参考标准，再用 filter: "ungraded" 获取待批改队列。如果没有示例提交，请先到 TaskNeo Web 界面手动批改并标记一份。
获取某个提交的完整详情，包括学生的书面内容和附件元数据。在批改前需要查看学生实际提交内容时使用。参数
​
taskId
string
required
提交所属任务的 UUID。
​
submissionId
string
required
提交 UUID。可从 list_submissions 获取。
返回值包含正文文本和附件元数据的完整提交对象。
为提交设置分数和/或书面反馈。你可以独立更新任一字段 - 省略另一项即可保持不变。参数
​
taskId
string
required
提交所属任务的 UUID。
​
submissionId
string
required
要评分的提交 UUID。
​
score
string | null
以字符串形式表示的分数，例如 "85" 或 "92.5"。设为 null 可清除已有分数。
​
reviewNote
string | null
给学生的书面反馈。设为 null 可清除已有反馈。
返回值包含新分数和评语的更新后提交对象。
分数以字符串存储，以支持灵活的评分方案（例如 "A+"、"85/100"）。你的 AI 工具可以使用你为班级设定的任何格式。
切换提交的示例状态。示例提交会作为 AI 辅助批量批改的参考标准。将提交标记为示例前的要求：
  • The submission must have a score set.
  • The submission must have a review note of at least 30 characters.
如果这些条件不满足，工具会返回错误。参数
​
taskId
string
required
提交所属任务的 UUID。
​
submissionId
string
required
要切换状态的提交 UUID。
返回值包含新的 isExemplary 值的更新后提交对象。