摘要
Moodle 学习平台通过其 Web 服务 REST 协议:课程和课程内容、参与者、用户、成绩、活动完成情况、作业和提交、测验、日历和截止日期、论坛和消息。站点 URL 和 Web 服务令牌。
引导式设置
2 分钟将 Moodle 连接到 Gemini
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Moodle,再把你的 MCP URL 添加到 Gemini。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Moodle 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 不需要安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Moodle,输入你的 Moodle 站点地址和 Web 服务令牌,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Moodle + Gemini
Moodle 学习平台通过其 Web 服务 REST 协议:课程和课程内容、参与者、用户、成绩、活动完成情况、作业和提交、测验、日历和截止日期、论坛和消息。站点 URL 和 Web 服务令牌。
前提条件
请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
MOODLE_URL, MOODLE_TOKEN
第一步 — 获取凭证
由 Moodle 管理员设置(大约 10 分钟)
- 站点管理,常规,高级功能:勾选 启用 Web 服务 并保存。
- 站点管理,服务器,Web 服务,管理协议:启用 REST 协议。
- Web 服务,外部服务:添加一个服务(已启用),然后 添加功能 并添加下面列表中命名的功能。内置的 Moodle 移动 Web 服务 已经包含了所有功能,除了
core_user_get_users,当 移动应用,移动设置,启用移动设备的 Web 服务 开启时可以使用。 - 选择连接器所代表的用户,理想情况下是一个专用账户。其角色需要具备 使用 REST 协议 (
webservice/rest:use) 的能力,以及你想要读取的权限:参与者、他人的成绩和提交的教师或管理员角色。 - Web 服务,管理令牌,创建令牌:选择该用户和服务,保存并将令牌复制到
MOODLE_TOKEN。 - 将站点地址放入
MOODLE_URL,末尾不加斜杠,例如https://moodle.myschool.org。
没有管理员权限的用户可以使用他们自己的移动服务令牌,当站点允许时,在 偏好设置,安全密钥 下显示。连接器将看到该用户所看到的内容。
从哪里开始:moodle_get_site_info 检查令牌并返回 userid。然后使用 moodle_list_my_courses(或 moodle_list_user_courses)获取所有其他所需的课程 ID。
课程:moodle_list_my_courses,moodle_list_user_courses,moodle_search_courses,moodle_get_courses_by_field,moodle_list_courses(所有课程,管理员令牌),moodle_list_categories 和 moodle_get_course_contents 用于获取章节、活动和文件。
人员:moodle_list_enrolled_users(课程参与者),moodle_get_users_by_field(按 ID、用户名、电子邮件、ID 号码精确查找),moodle_search_users(仅限自定义服务)。
进度:moodle_get_grade_items(课程的成绩报告),moodle_get_course_grades_overview(跨课程的最终成绩),moodle_get_completion_status(活动完成情况)。
活动:moodle_list_assignments,moodle_list_assignment_submissions,moodle_list_quizzes。 日历:moodle_list_calendar_events,moodle_list_upcoming_deadlines。 论坛:moodle_list_forums,moodle_list_forum_discussions,moodle_get_discussion_posts。 消息:moodle_list_conversations 和 moodle_send_message,唯一的写入工具。
工具背后的功能(将这些添加到自定义服务中):core_webservice_get_site_info,core_course_get_enrolled_courses_by_timeline_classification,core_enrol_get_users_courses,core_course_get_courses,core_course_get_courses_by_field,core_course_search_courses,core_course_get_contents,core_course_get_categories,core_enrol_get_enrolled_users,core_user_get_users_by_field,core_user_get_users,gradereport_user_get_grade_items,gradereport_overview_get_course_grades,core_completion_get_activities_completion_status,mod_assign_get_assignments,mod_assign_get_submissions,mod_quiz_get_quizzes_by_courses,core_calendar_get_calendar_events,core_calendar_get_action_events_by_timesort,mod_forum_get_forums_by_courses,mod_forum_get_forum_discussions,mod_forum_get_discussion_posts,core_message_get_conversations,core_message_send_instant_messages。
错误伴随 HTTP 200:Moodle 用状态 200 回应失败的调用,响应体中包含 exception、errorcode 和 message。连接器将其视为失败的调用。常见代码:invalidtoken(令牌错误、过期或已删除),accessexception(该功能不在令牌的服务中,或 Web 服务关闭),nopermissions(用户缺少能力,消息中有说明),invalidparameter(值类型错误)和 invalidrecord(没有此 ID)。许多工具在跳过单个项目时也会返回 warnings:请阅读它们。
ID:Moodle 每个活动有三个 ID。cmid(课程模块 ID)是页面地址中的 ID 和 moodle_get_course_contents 中的 ID;instance(或在作业、测验和论坛列表中的 id)是活动工具所使用的。用户、课程和组 ID 是普通数字。
值:时间为 Unix 秒(0 表示未设置)。标志为数字:1 表示是,0 表示否;Moodle 拒绝使用 true 和 false 这两个词。文本如 summary、intro 和 message 为 HTML。
权限:每个调用都以令牌用户的身份运行。学生令牌读取自己的课程、成绩和截止日期;参与者列表、他人的成绩和提交需要教师或管理员权限。没有文档记录的速率限制;站点自身的容量是限制,因此更倾向于一次调用多个课程 ID,而不是每个课程一次调用。
第二步 — 安装适配器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
第三步 — 在 Gemini 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Gemini CLI 从 ~/.gemini/settings.json(Windows 上为 %USERPROFILE%\.gemini\settings.json)读取 MCP 服务器。添加:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换
YOUR_MCP_API_KEY。 - 保存文件并重启
gemini。 - 在 Gemini CLI 中运行
/mcp(或在终端运行gemini mcp list)—anythingmcp应显示为已连接。 - 开始输入提示 — Gemini CLI 现在可以调用
Moodle的工具。
可用工具
| 工具 | 功能 |
|---|---|
moodle_get_site_info | 读取站点和令牌所属用户的信息:站点名称、站点 URL、版本(Moodle 版本)、用户 ID、用户名、全名、语言及是否… |
moodle_list_my_courses | 列出令牌用户在 Moodle 仪表板上的课程:ID、全名、短名、摘要、开始日期、结束日期(Unix 秒)… |
moodle_list_user_courses | 列出用户注册的课程:ID、短名、全名、类别、开始日期、结束日期、最后访问(Unix 秒)、进度… |
moodle_list_courses | 按 ID 读取课程及其设置:ID、短名、全名、类别 ID、摘要、格式、开始日期、结束日期、可见性、节数… |
moodle_get_courses_by_field | 按一个字段查找课程并读取令牌用户可能看到的内容:ID、全名、短名、类别 ID、类别名称、摘要… |
moodle_search_courses | 按文本搜索课程目录:按课程 ID、全名、短名、类别 ID、类别名称、摘要、联系人(教师)等… |
moodle_get_course_contents | 读取课程内容:其章节(ID、名称、摘要、章节编号、可见性)以及每个章节中的活动和资源… |
moodle_list_categories | 列出课程类别:ID、名称、描述、父级(顶级为 0)、课程数量、深度和路径。没有过滤器时每个类别… |
moodle_list_enrolled_users | 列出课程参与者:ID、用户名、全名、电子邮件、ID 号码、部门、最后访问和最后课程访问(Unix 秒)… |
moodle_get_users_by_field | 按 ID、用户名、电子邮件或 ID 号码查找用户(精确值):ID、用户名、名、姓、全名、电子邮件、部门、ID 号码… |
moodle_search_users | 按一个字段搜索站点用户:ID、用户名、名、姓、全名、电子邮件、ID 号码、部门、最后访问等… |
moodle_get_grade_items | 读取课程的成绩报告:按用户 gradeitems 包含项目名称、项目类型(mod、category、course)、项目模块、评分… |
moodle_get_course_grades_overview | 读取用户在每个注册课程中的最终成绩:课程 ID、成绩(显示的)和原始成绩。使用… |
moodle_get_completion_status | 读取用户完成的课程活动:按活动 cmid、modname、instance、状态(0 未完成,1 已完成,2… |
moodle_list_assignments | 列出课程的作业:按课程 assignments 包含 ID、cmid、名称、简介、截止日期、允许提交的开始日期、截止日期… |
moodle_list_assignment_submissions | 列出作业的提交:按作业 submissions 包含 ID、用户 ID、尝试次数、状态(新、草稿、已提交、重新打开)… |
moodle_list_quizzes | 列出课程的测验:ID、课程模块、课程、名称、简介、开放时间、关闭时间(Unix 秒,未设置时为 0)、时间限制… |
moodle_list_calendar_events | 列出日历事件:ID、名称、描述、课程 ID、组 ID、用户 ID、模块名称、实例、事件类型(用户、课程、组、站点、截止… |
moodle_list_upcoming_deadlines | 列出令牌用户接下来需要完成的事项,如 Moodle 时间线所示:事件包括需要提交的作业或测验… |
moodle_list_forums | 列出课程的论坛:ID、课程、名称、简介、类型(新闻、常规、问答、单一等)、cmid、讨论数量… |
moodle_list_forum_discussions | 列出论坛的讨论:按讨论 discussion(用于 moodle_get_discussion_posts 的讨论 ID)、名称、主题、消息… |
moodle_get_discussion_posts | 读取论坛讨论的所有帖子:ID、主题、消息(HTML)、作者(ID、全名)、父 ID(回复的帖子)、创建时间… |
moodle_list_conversations | 列出令牌用户的私人对话:ID、名称、类型(1 为两个用户之间,2 为组,3 为自我笔记)、成员数量、未读数量… |
moodle_send_message | 从令牌用户向另一用户发送私人 Moodle 消息。接收者会根据其 Moodle 偏好设置(网页、电子邮件…)收到通知。 |
示例提示
- "我本周课程中有哪些作业到期?"
- "列出课程 42 中未提交论文作业的参与者。"
- "显示我在所有课程中的成绩概览。"
- "生物 101 课程中有哪些活动我还未完成?"
- "总结课程论坛中的最新讨论。"
常见问题
令牌来自哪里? Moodle 管理员启用 Web 服务和 REST 协议,添加一个包含工具使用的功能的服务(内置的 Moodle 移动 Web 服务已经包含了所有功能,除了一个),并为用户创建一个令牌。用户还可以在站点允许时使用其自己的移动服务令牌,位于 偏好设置,安全密钥 下。在 AnythingMCP Cloud 上,站点必须通过 HTTPS 从互联网可访问。
它能看到什么? 正是令牌用户可能看到的内容:学生令牌读取自己的课程、成绩和截止日期;参与者、他人的成绩和提交需要教师或管理员权限。它涵盖课程和内容、用户、成绩、活动完成情况、作业和提交、测验、日历、论坛和私人消息,适用于 Moodle 4 和 5,自托管或 MoodleCloud。
哪些工具可以写入,哪些安装被关闭? 只有 moodle_send_message 可以写入,它发送私人消息。没有安装被关闭。
Gemini CLI 从哪里读取 MCP 服务器? 用户级配置位于 ~/.gemini/settings.json,项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。
下一步
这份指南对你有帮助吗?