连接器指南阅读约 4 分钟24 个 MCP 工具7 种语言

将 Moodle 连接到 Cursor(MCP)

Moodle 学习平台通过其 Web 服务 REST 协议:课程和课程内容、参与者、用户、成绩、活动完成情况、作业和提交、测验、日历和截止日期、论坛和消息。站点 URL 和 Web 服务令牌。

HC作者:HelpCode 团队更新于 4 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

Moodle

Moodle

Moodle learning platform over its Web Services REST protocol: courses and course content, participants, users, grades, activity completion, assignments and submissions, quizzes, calendar and deadlines, forums and messages. Site URL and web service token.

个工具

24

区域

INTL

类别

教育

身份验证

Query Param Auth

所需环境变量

MOODLE_URLMOODLE_TOKEN
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

摘要

Moodle 学习平台通过其 Web 服务 REST 协议:课程和课程内容、参与者、用户、成绩、活动完成情况、作业和提交、测验、日历和截止日期、论坛和消息。站点 URL 和 Web 服务令牌。

引导式设置

2 分钟将 Moodle 连接到 Cursor

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Moodle,再把你的 MCP URL 添加到 Cursor。无需代码,也无需自行运行服务器。

无需信用卡 · 7 天试用 · 提供自托管方案

试试这样问

Moodle 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

Moodle · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 不需要安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Moodle,输入你的 Moodle 站点地址和 Web 服务令牌,生成一个 MCP API 密钥,完成。无需 Docker,无需 git clone,无需本地服务器。

Moodle + Cursor

Moodle 学习平台通过其 Web 服务 REST 协议:课程和课程内容、参与者、用户、成绩、活动完成情况、作业和提交、测验、日历和截止日期、论坛和消息。站点 URL 和 Web 服务令牌。

前提条件

请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:

MOODLE_URL, MOODLE_TOKEN

第一步 — 获取凭证

由 Moodle 管理员设置(大约 10 分钟)

  1. 站点管理,常规,高级功能:勾选 启用 Web 服务 并保存。
  2. 站点管理,服务器,Web 服务,管理协议:启用 REST 协议。
  3. Web 服务,外部服务:添加一个服务(已启用),然后 添加功能 并添加下面列表中命名的功能。内置的 Moodle 移动 Web 服务 已经包含了所有功能,除了 core_user_get_users,当 移动应用,移动设置,启用移动设备的 Web 服务 开启时可以使用。
  4. 选择连接器所代表的用户,理想情况下是一个专用账户。其角色需要具备 使用 REST 协议 (webservice/rest:use) 的能力,以及你想要读取的权限:参与者、他人的成绩和提交的教师或管理员角色。
  5. Web 服务,管理令牌,创建令牌:选择该用户和服务,保存并将令牌复制到 MOODLE_TOKEN。
  6. 将站点地址放入 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

第三步 — 在 Cursor 中添加连接器

你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(https://cloud.anythingmcp.com/mcp/…)。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换 YOUR_MCP_API_KEY。
  2. 保存文件并重启 Cursor。
  3. 打开 Cursor → Settings → MCP,确认 anythingmcp 已列出并处于已连接状态。
  4. 开始对话 — 智能体现在可以调用 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 可以写入,它发送私人消息。没有安装被关闭。

Cursor 免费套餐支持自定义 MCP 服务器吗? 支持 — Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

这份指南对你有帮助吗?

2 分钟将 Moodle 连接到 Cursor

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Moodle,再把你的 MCP URL 添加到 Cursor。无需代码,也无需自行运行服务器。

相关指南

连接器

将 Moodle 连接到 ChatGPT(MCP)

Moodle 学习平台通过其 Web 服务 REST 协议:课程和课程内容、参与者、用户、成绩、活动完成情况、作业和提交、测验、日历和截止日期、论坛和消息。站点 URL 和 Web 服务令牌。

连接器

将 Moodle 连接到 Claude(MCP)

Moodle 学习平台通过其 Web 服务 REST 协议:课程和课程内容、参与者、用户、成绩、活动完成情况、作业和提交、测验、日历和截止日期、论坛和消息。站点 URL 和 Web 服务令牌。

连接器

将 Moodle 连接到 Microsoft Copilot(MCP)

Moodle 学习平台通过其 Web 服务 REST 协议:课程和课程内容、参与者、用户、成绩、活动完成情况、作业和提交、测验、日历和截止日期、论坛和消息。站点 URL 和 Web 服务令牌。

连接器

将 Moodle 连接到 Gemini CLI(MCP)

Moodle 学习平台通过其 Web 服务 REST 协议:课程和课程内容、参与者、用户、成绩、活动完成情况、作业和提交、测验、日历和截止日期、论坛和消息。站点 URL 和 Web 服务令牌。

连接器

将 Moodle 连接到 Meta Muse(MCP)

Moodle 学习平台通过其 Web 服务 REST 协议:课程和课程内容、参与者、用户、成绩、活动完成情况、作业和提交、测验、日历和截止日期、论坛和消息。站点 URL 和 Web 服务令牌。

连接器

Moodle MCP 服务器:课程、成绩与作业

通过其 Web 服务 REST 协议的 Moodle 学习平台:课程和课程内容、参与者、用户、成绩、活动完成、作业和提交、测验、日历和截止日期、论坛和消息。站点 URL 和 Web 服务令牌。