classin-mcp-server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@classin-mcp-server add student Alice to course English 101"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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配置
需要设置以下环境变量:
环境变量 | 说明 | 获取方式 |
| 机构认证ID | 登录 eeo.cn 后台 → 学校设置 → API设置 |
| 机构认证密钥 | 登录 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.jsonAPI 文档
完整的 ClassIn API 文档请参考:https://docs.eeo.cn/api/zh-hans/
许可证
MIT
Available Tools
48 toolsclassin_add_activity_student添加活动成员AIdempotent
向LMS活动添加学生。
参数:
courseId: 课程ID
activityId: 活动ID
studentUids/studentUid: 学生UID列表(或单个UID)
返回:
成功返回操作结果
Inputs: no named parameters.
classin_add_class_students课节批量添加学生BIdempotent
向课节中批量添加学生。
参数:
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课程添加学生BIdempotent
向课程中添加学生或旁听。
参数:
courseId: 课程ID
studentUid: 学生UID
identity: 身份类型,1=学生,2=旁听
返回:
成功返回操作结果
Inputs: courseId (required), studentUid (required), identity, response_format.
classin_add_course_teacher课程添加老师AIdempotent
向课程中添加老师。
参数:
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添加机构学生AIdempotent
将已注册用户添加为机构学生。
参数:
studentUid: 用户UID
studentName: 学生姓名(可选,不传使用用户昵称)
返回:
成功返回操作结果
Inputs: studentUid (required), studentName, response_format.
classin_add_teacher添加机构老师AIdempotent
将已注册用户添加为机构老师。添加后可以在课程中指定为老师。
参数:
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活动ADestructiveIdempotent
删除LMS活动。删除后不可恢复。
参数:
courseId: 课程ID
activityId: 要删除的活动ID
返回:
成功返回操作结果
Inputs: courseId (required), activityId (required), response_format.
classin_delete_activity_student移除活动成员ADestructiveIdempotent
从LMS活动中移除学生。
参数:
courseId: 课程ID
activityId: 活动ID
studentUids/studentUid: 要移除的学生UID列表(或单个UID)
返回:
成功返回操作结果
Inputs: no named parameters.
classin_delete_class_students课节批量移除学生ADestructiveIdempotent
从课节中批量移除学生。
参数:
classId: 课节ID
studentUids: 学生UID数组,最多500个
返回:
成功返回操作结果
Inputs: classId (required), studentUids (required), response_format.
classin_delete_class_video删除课节视频BDestructiveIdempotent
删除单个课节的视频。删除后不可恢复。
参数:
classId: 课节ID
videoId: 视频ID
返回:
成功返回操作结果
Inputs: classId (required), videoId (required), response_format.
classin_delete_course_class删除课节BDestructiveIdempotent
删除课节。删除后不可恢复。
参数:
classId: 课节ID
返回:
成功返回操作结果
Inputs: classId (required), response_format.
classin_delete_course_student课程移除学生ADestructiveIdempotent
从课程中移除学生或旁听。
参数:
courseId: 课程ID
studentUid: 学生UID
返回:
成功返回操作结果
Inputs: courseId (required), studentUid (required), response_format.
classin_delete_file删除文件ADestructiveIdempotent
删除云盘中的文件。删除后不可恢复。
参数:
fileId: 要删除的文件ID
返回:
成功返回操作结果
Inputs: fileId (required), response_format.
classin_delete_folder删除文件夹ADestructiveIdempotent
删除云盘中的文件夹。删除后不可恢复。
参数:
folderId: 要删除的文件夹ID
返回:
成功返回操作结果
Inputs: folderId (required), response_format.
classin_delete_school_label删除机构标签ADestructiveIdempotent
删除机构标签。删除后不可恢复。
参数:
labelId: 要删除的标签ID
返回:
成功返回操作结果
Inputs: labelId (required), response_format.
classin_delete_unit删除LMS单元ADestructiveIdempotent
删除LMS学习单元。删除后不可恢复。
参数:
unitId: 要删除的单元ID
返回:
成功返回操作结果
Inputs: unitId (required), response_format.
classin_edit_course编辑课程AIdempotent
编辑ClassIn课程信息。
参数:
courseId: 课程ID(必填)
其他参数同创建课程,只传需要修改的字段
返回:
成功返回操作结果
Inputs: courseId (required), folderId, subjectId, courseName, +7 more.
classin_edit_course_class修改课节AIdempotent
修改课节信息。
参数:
classId: 课节ID(必填)
className: 新的课节名称
beginTime: 新的开始时间戳
endTime: 新的结束时间戳
teacherUid: 新的授课老师UID
seatNum: 新的可上台学生数量
返回:
成功返回操作结果
Inputs: classId (required), endTime, seatNum, beginTime, +3 more.
classin_edit_school_settings修改学校设置BIdempotent
修改机构/学校的全局设置。
参数:
allowTeacherCreateCourse: 是否允许老师创建课程 (0/1)
allowTeacherInviteStudent: 是否允许老师邀请学生 (0/1)
返回:
成功返回操作结果
Inputs: response_format, allowTeacherCreateCourse, allowTeacherInviteStudent.
classin_edit_school_student编辑机构学生AIdempotent
编辑机构学生信息(姓名)。
参数:
studentUid: 学生UID
studentName: 新的学生姓名
返回:
成功返回操作结果
Inputs: studentUid (required), studentName (required), response_format.
classin_edit_teacher编辑机构老师AIdempotent
编辑机构老师信息(姓名)。
参数:
teacherUid: 老师UID
teacherName: 新的老师姓名
返回:
成功返回操作结果
Inputs: teacherUid (required), teacherName (required), response_format.
classin_end_course结束课程BDestructiveIdempotent
结束ClassIn课程。结束后课程将不可用。
参数:
courseId: 课程ID
返回:
成功返回操作结果
Inputs: courseId (required), response_format.
classin_get_cloud_list获取文件夹内容ARead-onlyIdempotent
获取指定文件夹下的文件及文件夹列表。
参数:
folderId: 文件夹ID
返回:
文件和文件夹列表
Inputs: folderId (required), response_format.
classin_get_folder_list获取云盘文件夹列表ARead-onlyIdempotent
获取机构云盘根目录下两级的文件夹列表。
返回:
文件夹列表,包含文件夹ID、父级ID、名称等信息
Inputs: response_format.
classin_get_top_folder_id获取顶级文件夹IDARead-onlyIdempotent
获取机构云盘的顶级文件夹ID。
返回:
顶级文件夹ID
Inputs: response_format.
classin_get_webcast_url获取直播/回放地址ARead-onlyIdempotent
获取课程或课节的直播/回放播放器地址。
参数:
courseId: 课程ID
classId: 课节ID(可选,不传则获取课程直播地址)
返回:
直播/回放播放器URL
Inputs: courseId (required), classId, response_format.
classin_modify_group_nickname修改群成员班级昵称AIdempotent
批量修改课程班级群中所有学生和旁听生的班级昵称。
功能说明:
每创建一个标准课程时,系统会自动创建一个班级群
创建班级群时,系统默认使用"用户昵称"来设置群成员的名字(班级昵称)
此接口会用机构后台设置的"学生姓名"来替换群里的"班级昵称"
修改后,学生在IM班级群和教室上课时显示的都是学生姓名
使用场景:
解决学生在ClassIn客户端修改用户昵称后,老师在群里和教室里对不上号的问题
推荐在创建好课程并添加好学生/旁听生后调用此接口
参数:
courseId: 课程ID
返回:
成功返回操作结果
Inputs: courseId (required), response_format.
classin_modify_password修改用户密码ADestructiveIdempotent
修改ClassIn用户密码。
参数:
uid: 用户UID
password: 新的明文密码6-20位(与md5pass二选一)
md5pass: 新的MD5加密密码32位(与password二选一)
返回:
成功返回操作结果
Inputs: no named parameters.
classin_move_activity移动LMS活动BIdempotent
将单元下的活动整体移动到其他单元。
参数:
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活动AIdempotent
发布LMS活动,使其对学生可见。
参数:
courseId: 课程ID
activityId/activityIds: 要发布的活动ID(可传单个或列表)
返回:
成功返回操作结果
Inputs: no named parameters.
classin_remove_course_teacher课程移除老师BDestructiveIdempotent
从课程中移除老师。
参数:
courseId: 课程ID
teacherUid: 老师UID
返回:
成功返回操作结果
Inputs: courseId (required), teacherUid (required), response_format.
classin_rename_file重命名文件BIdempotent
重命名云盘中的文件。
参数:
fileId: 文件ID
fileName: 新的文件名称
返回:
成功返回操作结果
Inputs: fileId (required), fileName (required), response_format.
classin_rename_folder重命名文件夹AIdempotent
重命名云盘中的文件夹。
参数:
folderId: 文件夹ID
folderName: 新的文件夹名称
返回:
成功返回操作结果
Inputs: folderId (required), folderName (required), response_format.
classin_restart_using_teacher启用机构老师AIdempotent
重新启用已停用的机构老师。
参数:
teacherUid: 要启用的老师UID
返回:
成功返回操作结果
Inputs: teacherUid (required), response_format.
classin_set_class_video设置课节录课/直播/回放AIdempotent
批量设置课节的录课、直播、回放功能。
注意: 已结束的课节不能设置录课、直播等功能。
参数:
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停用机构老师ADestructiveIdempotent
停用机构老师。停用后该老师无法被指定为课程老师。
参数:
teacherUid: 要停用的老师UID
返回:
成功返回操作结果
Inputs: teacherUid (required), response_format.
classin_update_classroom_activity编辑LMS课堂活动AIdempotent
编辑LMS课堂活动信息。
参数:
courseId: 课程ID
activityId: 活动ID
其他参数可选,只传需要修改的字段
返回:
成功返回操作结果
Inputs: no named parameters.
classin_update_school_label修改机构标签BIdempotent
修改机构标签名称。
参数:
labelId: 标签ID
labelName: 新的标签名称
返回:
成功返回操作结果
Inputs: labelId (required), labelName (required), response_format.
classin_update_unit编辑LMS单元AIdempotent
编辑LMS学习单元信息。
参数:
unitId: 单元ID
name: 新的单元名称(可选)
content: 新的单元介绍(可选)
publishFlag: 新的发布状态(可选)
返回:
成功返回操作结果
Inputs: unitId (required), name, content, publishFlag, +1 more.
classin_update_video_lock_status修改视频锁定状态AIdempotent
修改课节视频的锁定状态。锁定后视频不能被删除。
参数:
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
Scored across 48 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for AI dialogue using various LLM models via AceDataCloud
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
An MCP server that integrates with Discord to provide AI-powered features.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI assistants to access and interact with Google Classroom data, allowing users to view courses, course details, and assignments through natural language commands.7MIT
- AlicenseBqualityDmaintenanceAn MCP server that integrates with the OpenClaw API to enable AI assistants to send messages across multiple platforms, execute system commands, and manage calendar events and emails.51MIT

Funplay MCP for Unityofficial
AlicenseNot gradedqualityAmaintenanceThis MCP server integrates AI assistants with Unity Editor, allowing them to create scenes, generate scripts, simulate input, and automate workflows using 91 built-in tools.329MIT- AlicenseAqualityDmaintenanceMCP server that connects AI assistants to Instructure Canvas LMS, enabling teachers and administrators to manage courses, assignments, grades, and more through natural language.8028 npm1MIT