Skip to main content
Glama

ClassIn MCP Server

MCP (Model Context Protocol) 服务器,用于集成 ClassIn(翼鸥教育)API。让 AI 助手能够管理 ClassIn 平台上的用户、课程、课节、云盘、直播和学习管理系统。

功能特性

用户管理 (8个工具)

  • classin_register_user - 注册用户

  • classin_modify_password - 修改用户密码

  • classin_add_teacher - 添加机构老师

  • classin_edit_teacher - 编辑机构老师

  • classin_stop_using_teacher - 停用机构老师

  • classin_restart_using_teacher - 启用机构老师

  • classin_add_school_student - 添加机构学生

  • classin_edit_school_student - 编辑机构学生

课程管理 (7个工具)

  • classin_add_course - 创建课程

  • classin_edit_course - 编辑课程

  • classin_end_course - 结束课程

  • classin_add_course_student - 课程添加学生

  • classin_delete_course_student - 课程移除学生

  • classin_add_course_teacher - 课程添加老师

  • classin_remove_course_teacher - 课程移除老师

课节管理 (5个工具)

  • classin_add_course_class - 创建课节

  • classin_edit_course_class - 修改课节

  • classin_delete_course_class - 删除课节

  • classin_add_class_students - 课节批量添加学生

  • classin_delete_class_students - 课节批量移除学生

云盘管理 (8个工具)

  • classin_add_cloud_folder - 创建云盘目录

  • classin_update_cloud_folder - 修改云盘目录

  • classin_delete_cloud_folder - 删除云盘目录

  • classin_upload_cloud_file - 上传云盘文件

  • classin_copy_cloud_file - 复制云盘文件

  • classin_move_cloud_file - 移动云盘文件

  • classin_delete_cloud_file - 删除云盘文件

  • classin_share_cloud_file - 分享云盘文件

直播与录课 (4个工具)

  • classin_set_class_video - 设置课节录课/直播/回放

  • classin_delete_class_video - 删除课节视频

  • classin_update_video_lock_status - 修改视频锁定状态

  • classin_get_webcast_url - 获取直播/回放地址

LMS学习管理 (11个工具)

  • classin_create_unit - 创建LMS单元

  • classin_update_unit - 编辑LMS单元

  • classin_delete_unit - 删除LMS单元

  • classin_create_activity_noclass - 创建LMS非课堂活动

  • classin_create_classroom_activity - 创建LMS课堂活动

  • classin_update_classroom_activity - 编辑LMS课堂活动

  • classin_release_activity - 发布LMS活动

  • classin_delete_activity - 删除LMS活动

  • classin_move_activity - 移动LMS活动

  • classin_add_activity_student - 添加活动成员

  • classin_delete_activity_student - 移除活动成员

机构管理 (4个工具)

  • classin_add_school_label - 创建机构标签

  • classin_update_school_label - 修改机构标签

  • classin_delete_school_label - 删除机构标签

  • classin_edit_school_settings - 修改学校设置

班级群管理 (1个工具)

  • classin_modify_group_nickname - 修改群成员班级昵称(批量将课程班级群中学生的昵称改为机构后台设置的学生姓名)

Resources(2项)

  • classin://lms/activity-types - LMS 活动类型枚举

  • classin://lms/endpoints - LMS v2 活动相关接口速查

总计: 48个工具

Related MCP server: MCP OpenClaw

安装

方式一:通过 npm 全局安装(推荐)

npm install -g classin-mcp-server

方式二:直接用 npx 运行(无需安装)

npx classin-mcp-server

方式三:从源码构建

git clone https://github.com/yuanlang12/classin-mcp-server.git
cd classin-mcp-server
npm install
npm run build

配置

需要设置以下环境变量:

环境变量

说明

获取方式

CLASSIN_SID

机构认证ID

登录 eeo.cn 后台 → 学校设置 → API设置

CLASSIN_SECRET

机构认证密钥

登录 eeo.cn 后台 → 学校设置 → API设置

使用方法

在 Cursor 中使用

编辑 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "classin": {
      "command": "npx",
      "args": ["-y", "classin-mcp-server"],
      "env": {
        "CLASSIN_SID": "your-sid",
        "CLASSIN_SECRET": "your-secret"
      }
    }
  }
}

在 Claude Desktop 中使用

编辑 Claude Desktop 配置文件:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "classin": {
      "command": "npx",
      "args": ["-y", "classin-mcp-server"],
      "env": {
        "CLASSIN_SID": "your-sid",
        "CLASSIN_SECRET": "your-secret"
      }
    }
  }
}

在 Claude Code 中使用

claude mcp add classin -- npx -y classin-mcp-server \
  --env CLASSIN_SID=your-sid \
  --env CLASSIN_SECRET=your-secret

响应格式

所有工具都支持 response_format 参数,可选值:

  • json - 返回原始JSON数据

  • markdown - 返回格式化的Markdown文本(默认)

开发

# 开发模式(自动重载)
npm run dev

# 构建
npm run build

# 运行
npm start

项目结构

classin-mcp-server/
├── src/
│   ├── index.ts              # 服务器入口
│   ├── constants.ts          # 常量定义
│   ├── schemas/
│   │   └── common.ts         # 通用Schema定义
│   ├── services/
│   │   └── api-client.ts     # API客户端
│   └── tools/
│       ├── user.ts           # 用户管理工具
│       ├── classroom.ts      # 课程课节管理工具
│       ├── cloud.ts          # 云盘管理工具
│       ├── broadcast.ts      # 直播录课工具
│       ├── lms.ts            # LMS学习管理工具
│       ├── school.ts         # 机构管理工具
│       └── group.ts          # 班级群管理工具
├── dist/                     # 编译输出
├── package.json
└── tsconfig.json

API 文档

完整的 ClassIn API 文档请参考:https://docs.eeo.cn/api/zh-hans/

许可证

MIT

Available Tools

48 tools
classin_add_activity_student添加活动成员A
Idempotent

向LMS活动添加学生。

参数:

  • courseId: 课程ID

  • activityId: 活动ID

  • studentUids/studentUid: 学生UID列表(或单个UID)

返回:

  • 成功返回操作结果

Inputs: no named parameters.

classin_add_class_students课节批量添加学生B
Idempotent

向课节中批量添加学生。

参数:

  • classId: 课节ID

  • studentUids: 学生UID数组,最多500个

返回:

  • 成功返回操作结果

Inputs: classId (required), studentUids (required), response_format.

classin_add_course创建课程A

创建ClassIn课程。课程是管理课节的容器。

参数:

  • courseName: 课程名称(必填),1-90字符

  • folderId: 可用资源文件夹ID

  • expiryTime: 过期时间戳,不传表示永不过期

  • mainTeacherUid: 班主任UID,可在客户端管理课程

  • subjectId: 学科分类ID (0:空, 1:语文, 2:数学, 3:英语...)

  • courseIntroduce: 课程简介,最长400字符

  • classroomSettingId: 教室设置ID

  • courseUniqueIdentity: 唯一标识,防止重复创建

  • allowAddFriend: 是否允许班级成员互相添加好友 (0/1)

  • allowStudentModifyNickname: 是否允许学生修改班级昵称 (0/1)

返回:

  • 成功返回课程ID

Inputs: courseName (required), folderId, subjectId, expiryTime, +7 more.

classin_add_course_class创建课节A

在课程下创建课节(单课)。

参数:

  • courseId: 所属课程ID(必填)

  • className: 课节名称(必填),1-90字符

  • beginTime: 开始时间戳(必填)

  • endTime: 结束时间戳(必填)

  • teacherUid: 授课老师UID(必填)

  • seatNum: 可上台学生数量,0-50,默认6

  • classUniqueIdentity: 唯一标识

返回:

  • 成功返回课节ID

Inputs: no named parameters.

classin_add_course_student课程添加学生B
Idempotent

向课程中添加学生或旁听。

参数:

  • courseId: 课程ID

  • studentUid: 学生UID

  • identity: 身份类型,1=学生,2=旁听

返回:

  • 成功返回操作结果

Inputs: courseId (required), studentUid (required), identity, response_format.

classin_add_course_teacher课程添加老师A
Idempotent

向课程中添加老师。

参数:

  • courseId: 课程ID

  • teacherUid: 老师UID(需要先添加为机构老师)

返回:

  • 成功返回操作结果

Inputs: courseId (required), teacherUid (required), response_format.

classin_add_school_label创建机构标签A

创建机构标签,用于对老师或学生进行分类管理。

参数:

  • labelName: 标签名称,最长20字符

  • labelType: 标签类型 (1=老师标签, 2=学生标签)

返回:

  • 成功返回标签ID

Inputs: labelName (required), labelType (required), response_format.

classin_add_school_student添加机构学生A
Idempotent

将已注册用户添加为机构学生。

参数:

  • studentUid: 用户UID

  • studentName: 学生姓名(可选,不传使用用户昵称)

返回:

  • 成功返回操作结果

Inputs: studentUid (required), studentName, response_format.

classin_add_teacher添加机构老师A
Idempotent

将已注册用户添加为机构老师。添加后可以在课程中指定为老师。

参数:

  • teacherUid: 用户UID

  • teacherName: 老师姓名(可选,不传使用用户昵称)

返回:

  • 成功返回操作结果

Inputs: teacherUid (required), teacherName, response_format.

classin_create_activity_noclass创建LMS非课堂活动A

在LMS单元下创建非课堂活动(作业/测验/录播课/学习资料/讨论/答题卡/打卡)。

参数:

  • courseId: 课程ID

  • unitId: 所属单元ID

  • activityType: 活动类型 (2=作业, 3=测验, 4=录播课, 5=学习资料, 6=讨论, 7=答题卡, 8=打卡)

  • name: 活动名称

  • teacherUid: 活动教师UID

  • startTime: 开始时间戳(秒,可选)

  • endTime: 结束时间戳(秒,可选)

返回:

  • 成功返回活动ID

Inputs: no named parameters.

classin_create_classroom_activity创建LMS课堂活动A

在LMS单元下创建课堂活动。

注意: 课堂是课节的升级版本,推荐新对接的机构使用课堂而非课节。

参数:

  • courseId: 课程ID

  • unitId: 所属单元ID(可选,不传则创建在无主题单元下)

  • name: 活动名称

  • teacherUid: 授课老师UID

  • startTime: 开始时间戳(秒)

  • endTime: 结束时间戳(秒)

  • seatNum: 上台人数(含老师,默认7)

返回:

  • 成功返回活动ID

Inputs: no named parameters.

classin_create_folder创建文件夹A

在云盘中创建新文件夹。

参数:

  • parentId: 父文件夹ID

  • folderName: 文件夹名称

返回:

  • 成功返回新文件夹ID

Inputs: parentId (required), folderName (required), response_format.

classin_create_unit创建LMS单元A

在课程下创建LMS学习单元。

注意: 使用 API v2,课程下不支持创建同名单元。

参数:

  • courseId: 课程ID

  • name: 单元名称(最长50字符)

  • content: 单元介绍(可选)

  • publishFlag: 发布状态 (0=草稿, 2=已发布,默认2)

返回:

  • 成功返回单元ID

Inputs: name (required), courseId (required), content, publishFlag, +1 more.

classin_delete_activity删除LMS活动A
DestructiveIdempotent

删除LMS活动。删除后不可恢复。

参数:

  • courseId: 课程ID

  • activityId: 要删除的活动ID

返回:

  • 成功返回操作结果

Inputs: courseId (required), activityId (required), response_format.

classin_delete_activity_student移除活动成员A
DestructiveIdempotent

从LMS活动中移除学生。

参数:

  • courseId: 课程ID

  • activityId: 活动ID

  • studentUids/studentUid: 要移除的学生UID列表(或单个UID)

返回:

  • 成功返回操作结果

Inputs: no named parameters.

classin_delete_class_students课节批量移除学生A
DestructiveIdempotent

从课节中批量移除学生。

参数:

  • classId: 课节ID

  • studentUids: 学生UID数组,最多500个

返回:

  • 成功返回操作结果

Inputs: classId (required), studentUids (required), response_format.

classin_delete_class_video删除课节视频B
DestructiveIdempotent

删除单个课节的视频。删除后不可恢复。

参数:

  • classId: 课节ID

  • videoId: 视频ID

返回:

  • 成功返回操作结果

Inputs: classId (required), videoId (required), response_format.

classin_delete_course_class删除课节B
DestructiveIdempotent

删除课节。删除后不可恢复。

参数:

  • classId: 课节ID

返回:

  • 成功返回操作结果

Inputs: classId (required), response_format.

classin_delete_course_student课程移除学生A
DestructiveIdempotent

从课程中移除学生或旁听。

参数:

  • courseId: 课程ID

  • studentUid: 学生UID

返回:

  • 成功返回操作结果

Inputs: courseId (required), studentUid (required), response_format.

classin_delete_file删除文件A
DestructiveIdempotent

删除云盘中的文件。删除后不可恢复。

参数:

  • fileId: 要删除的文件ID

返回:

  • 成功返回操作结果

Inputs: fileId (required), response_format.

classin_delete_folder删除文件夹A
DestructiveIdempotent

删除云盘中的文件夹。删除后不可恢复。

参数:

  • folderId: 要删除的文件夹ID

返回:

  • 成功返回操作结果

Inputs: folderId (required), response_format.

classin_delete_school_label删除机构标签A
DestructiveIdempotent

删除机构标签。删除后不可恢复。

参数:

  • labelId: 要删除的标签ID

返回:

  • 成功返回操作结果

Inputs: labelId (required), response_format.

classin_delete_unit删除LMS单元A
DestructiveIdempotent

删除LMS学习单元。删除后不可恢复。

参数:

  • unitId: 要删除的单元ID

返回:

  • 成功返回操作结果

Inputs: unitId (required), response_format.

classin_edit_course编辑课程A
Idempotent

编辑ClassIn课程信息。

参数:

  • courseId: 课程ID(必填)

  • 其他参数同创建课程,只传需要修改的字段

返回:

  • 成功返回操作结果

Inputs: courseId (required), folderId, subjectId, courseName, +7 more.

classin_edit_course_class修改课节A
Idempotent

修改课节信息。

参数:

  • classId: 课节ID(必填)

  • className: 新的课节名称

  • beginTime: 新的开始时间戳

  • endTime: 新的结束时间戳

  • teacherUid: 新的授课老师UID

  • seatNum: 新的可上台学生数量

返回:

  • 成功返回操作结果

Inputs: classId (required), endTime, seatNum, beginTime, +3 more.

classin_edit_school_settings修改学校设置B
Idempotent

修改机构/学校的全局设置。

参数:

  • allowTeacherCreateCourse: 是否允许老师创建课程 (0/1)

  • allowTeacherInviteStudent: 是否允许老师邀请学生 (0/1)

返回:

  • 成功返回操作结果

Inputs: response_format, allowTeacherCreateCourse, allowTeacherInviteStudent.

classin_edit_school_student编辑机构学生A
Idempotent

编辑机构学生信息(姓名)。

参数:

  • studentUid: 学生UID

  • studentName: 新的学生姓名

返回:

  • 成功返回操作结果

Inputs: studentUid (required), studentName (required), response_format.

classin_edit_teacher编辑机构老师A
Idempotent

编辑机构老师信息(姓名)。

参数:

  • teacherUid: 老师UID

  • teacherName: 新的老师姓名

返回:

  • 成功返回操作结果

Inputs: teacherUid (required), teacherName (required), response_format.

classin_end_course结束课程B
DestructiveIdempotent

结束ClassIn课程。结束后课程将不可用。

参数:

  • courseId: 课程ID

返回:

  • 成功返回操作结果

Inputs: courseId (required), response_format.

classin_get_cloud_list获取文件夹内容A
Read-onlyIdempotent

获取指定文件夹下的文件及文件夹列表。

参数:

  • folderId: 文件夹ID

返回:

  • 文件和文件夹列表

Inputs: folderId (required), response_format.

classin_get_folder_list获取云盘文件夹列表A
Read-onlyIdempotent

获取机构云盘根目录下两级的文件夹列表。

返回:

  • 文件夹列表,包含文件夹ID、父级ID、名称等信息

Inputs: response_format.

classin_get_top_folder_id获取顶级文件夹IDA
Read-onlyIdempotent

获取机构云盘的顶级文件夹ID。

返回:

  • 顶级文件夹ID

Inputs: response_format.

classin_get_webcast_url获取直播/回放地址A
Read-onlyIdempotent

获取课程或课节的直播/回放播放器地址。

参数:

  • courseId: 课程ID

  • classId: 课节ID(可选,不传则获取课程直播地址)

返回:

  • 直播/回放播放器URL

Inputs: courseId (required), classId, response_format.

classin_modify_group_nickname修改群成员班级昵称A
Idempotent

批量修改课程班级群中所有学生和旁听生的班级昵称。

功能说明:

  • 每创建一个标准课程时,系统会自动创建一个班级群

  • 创建班级群时,系统默认使用"用户昵称"来设置群成员的名字(班级昵称)

  • 此接口会用机构后台设置的"学生姓名"来替换群里的"班级昵称"

  • 修改后,学生在IM班级群和教室上课时显示的都是学生姓名

使用场景:

  • 解决学生在ClassIn客户端修改用户昵称后,老师在群里和教室里对不上号的问题

  • 推荐在创建好课程并添加好学生/旁听生后调用此接口

参数:

  • courseId: 课程ID

返回:

  • 成功返回操作结果

Inputs: courseId (required), response_format.

classin_modify_password修改用户密码A
DestructiveIdempotent

修改ClassIn用户密码。

参数:

  • uid: 用户UID

  • password: 新的明文密码6-20位(与md5pass二选一)

  • md5pass: 新的MD5加密密码32位(与password二选一)

返回:

  • 成功返回操作结果

Inputs: no named parameters.

classin_move_activity移动LMS活动B
Idempotent

将单元下的活动整体移动到其他单元。

参数:

  • courseId: 课程ID

  • unitId: 源单元ID

  • toUnitId: 目标单元ID

返回:

  • 成功返回操作结果

Inputs: unitId (required), courseId (required), toUnitId (required), response_format.

classin_register_user注册用户A

注册ClassIn用户账号。为机构的用户代注册ClassIn账号。

重要: 调用此接口前,请保证所传的手机号或邮箱用户对此代注册操作知情并同意。

参数:

  • telephone: 手机号(与email二选一)。中国大陆格式: 15800000001; 国际格式: 00国家号-手机号

  • email: 邮箱(与telephone二选一)

  • nickname: 昵称/姓名,最长24字符

  • password: 明文密码6-20位(与md5pass二选一)

  • md5pass: MD5加密密码32位(与password二选一)

  • addToSchoolMember: 0=不加为机构成员, 1=加为机构学生, 2=加为机构老师

返回:

  • 成功返回用户UID(唯一标识)

  • 如果手机号/邮箱已注册,返回错误码135/461,但仍会返回已存在用户的UID

Inputs: no named parameters.

classin_release_activity发布LMS活动A
Idempotent

发布LMS活动,使其对学生可见。

参数:

  • courseId: 课程ID

  • activityId/activityIds: 要发布的活动ID(可传单个或列表)

返回:

  • 成功返回操作结果

Inputs: no named parameters.

classin_remove_course_teacher课程移除老师B
DestructiveIdempotent

从课程中移除老师。

参数:

  • courseId: 课程ID

  • teacherUid: 老师UID

返回:

  • 成功返回操作结果

Inputs: courseId (required), teacherUid (required), response_format.

classin_rename_file重命名文件B
Idempotent

重命名云盘中的文件。

参数:

  • fileId: 文件ID

  • fileName: 新的文件名称

返回:

  • 成功返回操作结果

Inputs: fileId (required), fileName (required), response_format.

classin_rename_folder重命名文件夹A
Idempotent

重命名云盘中的文件夹。

参数:

  • folderId: 文件夹ID

  • folderName: 新的文件夹名称

返回:

  • 成功返回操作结果

Inputs: folderId (required), folderName (required), response_format.

classin_restart_using_teacher启用机构老师A
Idempotent

重新启用已停用的机构老师。

参数:

  • teacherUid: 要启用的老师UID

返回:

  • 成功返回操作结果

Inputs: teacherUid (required), response_format.

classin_set_class_video设置课节录课/直播/回放A
Idempotent

批量设置课节的录课、直播、回放功能。

注意: 已结束的课节不能设置录课、直播等功能。

参数:

  • classIds: 课节ID数组,最多100个

  • isRecord: 是否录课 (0=关闭, 1=开启)

  • isLive: 是否直播 (0=关闭, 1=开启)

  • isPlayback: 是否回放 (0=关闭, 1=开启)

返回:

  • 成功返回操作结果

Inputs: isLive (required), classIds (required), isRecord (required), isPlayback (required), +1 more.

classin_stop_using_teacher停用机构老师A
DestructiveIdempotent

停用机构老师。停用后该老师无法被指定为课程老师。

参数:

  • teacherUid: 要停用的老师UID

返回:

  • 成功返回操作结果

Inputs: teacherUid (required), response_format.

classin_update_classroom_activity编辑LMS课堂活动A
Idempotent

编辑LMS课堂活动信息。

参数:

  • courseId: 课程ID

  • activityId: 活动ID

  • 其他参数可选,只传需要修改的字段

返回:

  • 成功返回操作结果

Inputs: no named parameters.

classin_update_school_label修改机构标签B
Idempotent

修改机构标签名称。

参数:

  • labelId: 标签ID

  • labelName: 新的标签名称

返回:

  • 成功返回操作结果

Inputs: labelId (required), labelName (required), response_format.

classin_update_unit编辑LMS单元A
Idempotent

编辑LMS学习单元信息。

参数:

  • unitId: 单元ID

  • name: 新的单元名称(可选)

  • content: 新的单元介绍(可选)

  • publishFlag: 新的发布状态(可选)

返回:

  • 成功返回操作结果

Inputs: unitId (required), name, content, publishFlag, +1 more.

classin_update_video_lock_status修改视频锁定状态A
Idempotent

修改课节视频的锁定状态。锁定后视频不能被删除。

参数:

  • classId: 课节ID

  • videoId: 视频ID

  • isLock: 锁定状态 (0=解锁, 1=锁定)

返回:

  • 成功返回操作结果

Inputs: isLock (required), classId (required), videoId (required), response_format.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 48 tools

    Disambiguation3/5

    Most tools target distinct resources, but there is overlap between legacy course classes (add_course_class) and newer classroom activities (create_classroom_activity), which are conceptually similar. The 'noclass' suffix in create_activity_noclass is also ambiguous. Descriptions help but the boundaries are not always crystal clear.

    Naming Consistency4/5

    All tools follow the classin_verb_noun pattern with consistent naming. Minor inconsistencies include plural/singular mismatches (add_class_students vs add_course_student) and the awkward noclass suffix, but overall the pattern is predictable.

    Tool Count2/5

    With 48 tools, the server is quite heavy, exceeding the 25-tool threshold. While the broad scope of the ClassIn platform justifies many operations, the sheer number makes it unwieldy for an agent to navigate.

    Completeness2/5

    The tool surface is heavily write-focused with very few read operations. There are no listing or retrieval tools for courses, classes, activities, students, or teachers, which means agents cannot query the current state. Lifecycle coverage also has gaps, such as no delete for school students or courses.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers