|
|
---
|
|
|
name: educoder
|
|
|
description: 提供头歌Educoder实践教学平台的查询服务，包括用户登录、课堂管理、作业查询、实训项目查询、考试管理等功能。
|
|
|
---
|
|
|
|
|
|
## MCP 服务地址
|
|
|
|
|
|
- 本地开发：`http://localhost:8000/sse`
|
|
|
- 远程服务：`http://143.64.38.7:37010/sse`
|
|
|
|
|
|
> 使用 SSE 模式连接，客户端配置时填写上述地址之一即可。
|
|
|
|
|
|
## 注意事项
|
|
|
- 不要用 copaw 调 mcp 服务，优先使用 npx mcporter。
|
|
|
- 头歌平台需要登录后才能使用，请确保环境变量配置正确。
|
|
|
|
|
|
## 前置配置（只需一次）
|
|
|
|
|
|
### 第一步：设置环境变量
|
|
|
|
|
|
**macOS / Linux：**
|
|
|
```
|
|
|
export EDUCODER_LOGIN="你的头歌账号"
|
|
|
export EDUCODER_PASSWORD="你的头歌密码"
|
|
|
```
|
|
|
|
|
|
**Windows（PowerShell）：**
|
|
|
```
|
|
|
$env:EDUCODER_LOGIN="你的头歌账号"
|
|
|
$env:EDUCODER_PASSWORD="你的头歌密码"
|
|
|
```
|
|
|
|
|
|
**Windows（CMD）：**
|
|
|
```
|
|
|
set EDUCODER_LOGIN=你的头歌账号
|
|
|
set EDUCODER_PASSWORD=你的头歌密码
|
|
|
```
|
|
|
|
|
|
> **没有配置账号密码？** 所有工具调用都会返回鉴权失败。请先完成上述步骤。
|
|
|
|
|
|
### 第二步：运行安装脚本
|
|
|
|
|
|
**macOS / Linux：**
|
|
|
```
|
|
|
bash setup.sh
|
|
|
```
|
|
|
|
|
|
**Windows 或任何有 Node.js 的环境：**
|
|
|
```
|
|
|
node setup.js
|
|
|
```
|
|
|
|
|
|
> 具体配置文件路径取决于你使用的客户端（OpenClaw / CodeBuddy / Cursor 等），请参考对应文档。
|
|
|
|
|
|
### 第三步：安装后验证
|
|
|
|
|
|
**安装成功后，必须立刻执行：`educoder_login` 以验证账号配置与服务是否可用。**
|
|
|
|
|
|
- 判断登录失败 -> 提示检查账号密码是否正确
|
|
|
- 判断登录成功 -> 正常返回用户信息，说明配置成功
|
|
|
- 当用户提供账号密码后，需要帮助用户直接更新环境变量，不需要用户自己执行
|
|
|
|
|
|
---
|
|
|
|
|
|
## 触发场景
|
|
|
|
|
|
### 意图 → 工具 速查表
|
|
|
|
|
|
| 用户意图 | 调用工具 |
|
|
|
|----------|---------|
|
|
|
| 登录头歌 / 登录Educoder | `educoder_login` |
|
|
|
| 查询账号 / 我的信息 / 我是谁 | `educoder_current_user` |
|
|
|
| 查询我的课堂 / 我教了哪些课 | `educoder_my_courses` |
|
|
|
| 查询课堂学生 / XX课堂有哪些学生 | `educoder_course_students` |
|
|
|
| 查询课堂信息 / 课堂设置 | `educoder_course_info` |
|
|
|
| 查询课堂分班 | `educoder_course_groups` |
|
|
|
| 查询作业列表 / 课堂有哪些作业 | `educoder_homework_list` |
|
|
|
| 查询作业提交情况 / 学生作业完成情况 | `educoder_homework_detail` |
|
|
|
| 查询考试列表 / 课堂有哪些考试 | `educoder_exercises` |
|
|
|
| 搜索实训 / 查找实训项目 | `educoder_shixun_search` |
|
|
|
| 查询实训详情 / XX实训的信息 | `educoder_shixun_info` |
|
|
|
| 查询我的实训 / 我管理的实训项目 | `educoder_my_shixuns` |
|
|
|
| 查询我的实践课程 | `educoder_my_subjects` |
|
|
|
|
|
|
### 不要触发的情况
|
|
|
|
|
|
- 讨论教学方法（不是在查询数据）
|
|
|
- 纯聊天中提到"课堂"、"作业"
|
|
|
- 与头歌Educoder平台无关的场景
|
|
|
- 要求修改成绩、删除数据等写操作
|
|
|
|
|
|
### 组合调用示例
|
|
|
|
|
|
> 用户说："帮我看看我是谁，还有我教了哪些课"
|
|
|
|
|
|
依次调用：
|
|
|
1. `educoder_login`（如未登录）
|
|
|
2. `educoder_current_user`
|
|
|
3. `educoder_my_courses`
|
|
|
|
|
|
> 用户说："查询高等数学课堂的学生和作业情况"
|
|
|
|
|
|
依次调用：
|
|
|
1. `educoder_my_courses`（获取课堂ID）
|
|
|
2. `educoder_course_students`
|
|
|
3. `educoder_homework_list`
|
|
|
|
|
|
---
|
|
|
|
|
|
## 工具详细说明
|
|
|
|
|
|
### 全局规则
|
|
|
|
|
|
- **登录前置**：如果工具调用返回鉴权失败，先调用 `educoder_login` 登录后重试
|
|
|
- **课堂ID获取**：查询课堂相关信息时，如果用户给的是课堂名称，先通过 `educoder_my_courses` 获取课堂列表找到对应ID
|
|
|
- **用户名获取**：需要username参数的工具，先调用 `educoder_current_user` 获取用户名
|
|
|
- **mcp 服务使用注意事项**：
|
|
|
- 推荐使用 npx mcporter 调用 MCP 服务（无需全局安装），不建议直接使用 curl；
|
|
|
- 严禁使用 copaw 调用 MCP，必须改用 mcporter；
|
|
|
- 如果 mcp 服务提示鉴权失败，请引导用户检查 EDUCODER_LOGIN 和 EDUCODER_PASSWORD 环境变量；
|
|
|
- 如果 mcp 服务找不到，注意指定 mcp 配置文件的路径；
|
|
|
- 如果调用失败，可以换一种方式重试，但若多次尝试仍不成功，请停止并检查配置；
|
|
|
- 调用需要参数的 MCP 工具时，必须传入完整的结构化 JSON 参数对象；
|
|
|
- 严禁 mcporter 在调用需要参数的 MCP 工具时，遗漏 `--args`。
|
|
|
|
|
|
---
|
|
|
|
|
|
### 1. `educoder_login`
|
|
|
|
|
|
登录头歌Educoder平台，获取会话凭证。
|
|
|
|
|
|
**典型问法：** "登录头歌" / "帮我登录Educoder" / "进行身份认证"
|
|
|
|
|
|
**参数：** 无（从环境变量 EDUCODER_LOGIN 和 EDUCODER_PASSWORD 读取）
|
|
|
|
|
|
**交互规则：**
|
|
|
- 首次使用或会话过期时必须调用
|
|
|
- 登录成功后才能调用其他工具
|
|
|
|
|
|
---
|
|
|
|
|
|
### 2. `educoder_current_user`
|
|
|
|
|
|
查询当前登录用户的信息。
|
|
|
|
|
|
**典型问法：** "我是谁" / "我的账号信息" / "查询当前用户"
|
|
|
|
|
|
**参数：** 无
|
|
|
|
|
|
**返回内容包括：** 用户名、用户ID、角色信息、所属学校等
|
|
|
|
|
|
---
|
|
|
|
|
|
### 3. `educoder_my_courses`
|
|
|
|
|
|
查询当前用户教授或管理的课堂列表。
|
|
|
|
|
|
**典型问法：** "我教了哪些课" / "我的课堂列表" / "查询我的课程"
|
|
|
|
|
|
**参数：** 无
|
|
|
|
|
|
**返回内容包括：** 课堂名称、课堂ID、课程状态、学生人数等
|
|
|
|
|
|
**注意：** 返回结果中的 emoji 需保留。
|
|
|
|
|
|
---
|
|
|
|
|
|
### 4. `educoder_course_students`
|
|
|
|
|
|
查询指定课堂的学生名单。
|
|
|
|
|
|
**典型问法：** "XX课堂有哪些学生" / "查询课堂学生名单" / "高等数学班的学生"
|
|
|
|
|
|
**参数：**
|
|
|
|
|
|
| 参数 | 必填 | 说明 |
|
|
|
|------|------|------|
|
|
|
| `courseId` | 是 | 课堂ID |
|
|
|
|
|
|
**使用逻辑：**
|
|
|
- 用户给课堂名称 → 先调 `educoder_my_courses` 获取课堂列表，找到对应 `courseId`，再调本工具
|
|
|
- 用户直接给 `courseId` → 直接调用
|
|
|
|
|
|
---
|
|
|
|
|
|
### 5. `educoder_course_info`
|
|
|
|
|
|
查询指定课堂的详细信息。
|
|
|
|
|
|
**典型问法：** "查询课堂信息" / "XX课堂的设置" / "课堂详情"
|
|
|
|
|
|
**参数：**
|
|
|
|
|
|
| 参数 | 必填 | 说明 |
|
|
|
|------|------|------|
|
|
|
| `courseId` | 是 | 课堂ID |
|
|
|
|
|
|
**使用逻辑：**
|
|
|
- 用户给课堂名称 → 先调 `educoder_my_courses` 获取课堂列表，找到对应 `courseId`，再调本工具
|
|
|
- 用户直接给 `courseId` → 直接调用
|
|
|
|
|
|
---
|
|
|
|
|
|
### 6. `educoder_course_groups`
|
|
|
|
|
|
查询指定课堂的分班情况。
|
|
|
|
|
|
**典型问法：** "查询课堂分班" / "XX课堂有哪些分组" / "课堂分班情况"
|
|
|
|
|
|
**参数：**
|
|
|
|
|
|
| 参数 | 必填 | 说明 |
|
|
|
|------|------|------|
|
|
|
| `courseId` | 是 | 课堂ID |
|
|
|
|
|
|
**使用逻辑：**
|
|
|
- 用户给课堂名称 → 先调 `educoder_my_courses` 获取课堂列表，找到对应 `courseId`，再调本工具
|
|
|
- 用户直接给 `courseId` → 直接调用
|
|
|
|
|
|
---
|
|
|
|
|
|
### 7. `educoder_homework_list`
|
|
|
|
|
|
查询指定课堂的作业列表。
|
|
|
|
|
|
**典型问法：** "查询作业列表" / "XX课堂有哪些作业" / "课堂作业"
|
|
|
|
|
|
**参数：**
|
|
|
|
|
|
| 参数 | 必填 | 说明 |
|
|
|
|------|------|------|
|
|
|
| `courseId` | 是 | 课堂ID |
|
|
|
|
|
|
**使用逻辑：**
|
|
|
- 用户给课堂名称 → 先调 `educoder_my_courses` 获取课堂列表，找到对应 `courseId`，再调本工具
|
|
|
- 用户直接给 `courseId` → 直接调用
|
|
|
|
|
|
---
|
|
|
|
|
|
### 8. `educoder_homework_detail`
|
|
|
|
|
|
查询指定作业的详细提交情况。
|
|
|
|
|
|
**典型问法：** "查询作业提交情况" / "学生作业完成情况" / "作业详情"
|
|
|
|
|
|
**参数：**
|
|
|
|
|
|
| 参数 | 必填 | 说明 |
|
|
|
|------|------|------|
|
|
|
| `homeworkId` | 是 | 作业ID |
|
|
|
| `courseId` | 是 | 课堂ID |
|
|
|
|
|
|
**使用逻辑：**
|
|
|
- 用户给课堂名称 → 先调 `educoder_my_courses` 获取课堂列表，找到对应 `courseId`
|
|
|
- 用户给作业名称 → 先调 `educoder_homework_list` 获取作业列表，找到对应 `homeworkId`
|
|
|
- 再调本工具获取作业详情
|
|
|
|
|
|
---
|
|
|
|
|
|
### 9. `educoder_exercises`
|
|
|
|
|
|
查询指定课堂的考试/练习列表。
|
|
|
|
|
|
**典型问法：** "查询考试列表" / "课堂有哪些考试" / "练习列表"
|
|
|
|
|
|
**参数：**
|
|
|
|
|
|
| 参数 | 必填 | 说明 |
|
|
|
|------|------|------|
|
|
|
| `courseId` | 是 | 课堂ID |
|
|
|
|
|
|
**使用逻辑：**
|
|
|
- 用户给课堂名称 → 先调 `educoder_my_courses` 获取课堂列表，找到对应 `courseId`，再调本工具
|
|
|
- 用户直接给 `courseId` → 直接调用
|
|
|
|
|
|
---
|
|
|
|
|
|
### 10. `educoder_shixun_search`
|
|
|
|
|
|
搜索实训项目。
|
|
|
|
|
|
**典型问法：** "搜索实训" / "查找实训项目" / "搜索Python实训"
|
|
|
|
|
|
**参数：**
|
|
|
|
|
|
| 参数 | 必填 | 说明 |
|
|
|
|------|------|------|
|
|
|
| `keyword` | 是 | 搜索关键词 |
|
|
|
|
|
|
---
|
|
|
|
|
|
### 11. `educoder_shixun_info`
|
|
|
|
|
|
查询指定实训项目的详细信息。
|
|
|
|
|
|
**典型问法：** "查询实训详情" / "XX实训的信息" / "实训项目详情"
|
|
|
|
|
|
**参数：**
|
|
|
|
|
|
| 参数 | 必填 | 说明 |
|
|
|
|------|------|------|
|
|
|
| `shixunId` | 是 | 实训ID |
|
|
|
|
|
|
---
|
|
|
|
|
|
### 12. `educoder_my_shixuns`
|
|
|
|
|
|
查询当前用户管理或创建的实训项目列表。
|
|
|
|
|
|
**典型问法：** "查询我的实训" / "我管理的实训项目" / "我的实训列表"
|
|
|
|
|
|
**参数：** 无
|
|
|
|
|
|
---
|
|
|
|
|
|
### 13. `educoder_my_subjects`
|
|
|
|
|
|
查询当前用户的实践课程列表。
|
|
|
|
|
|
**典型问法：** "查询我的实践课程" / "我的课程列表" / "实践课程"
|
|
|
|
|
|
**参数：** 无
|
|
|
|
|
|
---
|
|
|
|
|
|
## 输出规范
|
|
|
|
|
|
- 结果结构化展示（列表或表格形式）
|
|
|
- 课堂信息至少包含：课堂名称、课堂ID
|
|
|
- 实训信息包含：实训名称、实训ID、状态
|
|
|
- 学生信息包含：学生姓名、学号、提交状态
|
|
|
- 作业信息包含：作业名称、作业ID、截止时间、提交情况
|
|
|
- 保留工具返回的原始文案，不要自由发挥改写
|
|
|
|
|
|
## 红线
|
|
|
|
|
|
- 不编造任何教学数据，必须依赖工具返回
|
|
|
- 不做权限外操作（如修改成绩、删除数据、添加学生等）
|
|
|
- 不暴露用户密码等敏感信息
|
|
|
- 不执行任何写操作，仅限查询
|
|
|
|
|
|
## 调用方式
|
|
|
|
|
|
```bash
|
|
|
# Mac 或 Linux 示例：登录头歌
|
|
|
npx mcporter call educoder-mcp educoder_login
|
|
|
|
|
|
# 查询我的课堂
|
|
|
npx mcporter call educoder-mcp educoder_my_courses
|
|
|
|
|
|
# 查询指定课堂的学生（需要courseId）
|
|
|
npx mcporter call educoder-mcp educoder_course_students --args '{"courseId": "xxx"}'
|
|
|
|
|
|
# 搜索实训项目
|
|
|
npx mcporter call educoder-mcp educoder_shixun_search --args '{"keyword": "Python"}'
|
|
|
```
|
