ClaudeMap

Moodle-MCP

零依赖只读 Moodle MCP 服务器:一个只用标准库的 Python 文件、十个工具,把作业、截止日期与课程文件从 Moodle Web Service API 直接读给 agent——不爬网页、不点浏览器(MIT)

MCP 服务器moodlelmseducationread-onlymcp

Moodle-MCP 把 Moodle(全球大量高校在用的 LMS)接成 MCP 工具(撰稿时 204 星,2026-11-09;当前版本 1.4.0):单个 server.py,只用 Python 标准库(urllib、json、ssl),零第三方依赖,面向任何开启 Web Services 与 REST 协议的 Moodle 3.x/4.x 站点(作者在 Moodle 4.3.6 全量 435 个函数授权下验证;MCP 协议 2024-11-05,Python 3.8+)。十个只读工具覆盖:moodle_weekly_digest 一次性汇总近期更新、临期与逾期;moodle_pending_assignments 把未交作业分成临期/逾期/不急并算好剩余天数;moodle_quiz_status(1.3.0 起)从 mod_quiz_get_user_attempts 读测验真实作答状态、最好成绩与开闭时间窗;moodle_course_files 列章节结构与文件直链(只给元数据,不下载);moodle_download_week(1.1.0 起)把某周课件与作业附件拉到本地、校验大小、跳过已有文件——只写本地盘,代码里不存在提交、选课、编辑或删除端点;另有 1.4.0 新增的 moodle_setup_guide 与 moodle_config_status 两个免 token 工具,令牌缺失时接手指引而非报错死路。请求串行化并间隔 150ms,避免触发站点 WAF。配套 skill moodle-course-watch(以 git submodule 挂在本仓库 skill/ 目录,也可单独取用)在其上做课程差异追踪、周文件夹镜像与未交清单工作流。

它做什么

  • 单个零依赖 Python 文件(只用标准库 urllib/json/ssl)——把 server.py 拷到任何地方,python server.py 即跑
  • 十个只读工具:每周摘要、未交作业按临期/逾期/不急分组、测验作答状态(1.3.0)、带直链的课程文件、按周下载(1.1.0)
  • 为截止日期而生:剩余天数直接算好;测验有独立工具,因为 mod_quiz 不是 mod_assign
  • 免 token 辅助工具(1.4.0):moodle_setup_guide 手把手带首次配置;moodle_config_status 自检配置、令牌只显示前 4 字符
  • 对 WAF 友好的工程:请求串行化并间隔 150ms——猛打 Moodle 会吃 502
  • 设计上只读——代码里不存在提交、选课、编辑或删除端点

什么时候用

适合学生把「我这周还欠什么」交给 agent 回答,也适合学校跑 Moodle 3.x/4.x 且开了 Web Services 的任何人批量核对课程动态;配套的 moodle-course-watch skill 适合想要「新课件出现就镜像、没交的列出来」这类持续工作流的人。

如何上手

# 1)取令牌:Moodle 网页端 → Preferences → Account → Security → Manage access keys → Create
#    (service 选 Moodle mobile web service;纯 SSO 账号只能走网页端——get_token.py 需要本地密码)

# 2)在 server.py 旁建 config.json(MOODLE_URL / MOODLE_TOKEN 环境变量优先级更高):
{
  "url": "https://moodle.your-school.edu",
  "token": "your_token_here"
}

# 3)在 Claude Desktop / Cursor 的 mcp.json 里注册:
{
  "mcpServers": {
    "moodle": {
      "command": "python",
      "args": ["<absolute path to server.py>"]
    }
  }
}

# 4)验证:让客户端调 moodle_site_info——应返回站点名、Moodle 版本与你的用户信息

注意事项

只读工具返回的文件直链已内嵌你的令牌——按机密对待,别进日志、截图和公开仓库;config.json 已被仓库的 .gitignore 排除,抓包请求体里会出现 wstoken。Turnitin 截止日期是盲区(turnitintooltwo 是独立模块、没有 mod_assign 语义、不暴露可用的截止字段)——只能去网页端看。测验截止日期按设计不出现在 moodle_weekly_digest 里,用 moodle_quiz_status 查。显示「未设置」的截止日期是老师压根没配。使用前提是站点级开启 Web Services 与 REST 协议、账号持有 webservice/rest:use——moodle_site_info 返回的函数列表很短就说明管理员只授了移动子集。作者在 Moodle 4.3.6 全量 435 函数授权下验证;MCP 协议 2024-11-05。配套 skill moodle-course-watch 是独立仓库、以 submodule 挂载。MIT。撰稿时 204 星(2026-11-09)。

代码仓库

Faixiang/Moodle-MCP

收录日期

地图上的相关资源

  • Blitz Strike

    MCP 服务器

    把渗透测试方法论装进一个 MCP server:BLITZ 摸清攻击面,EAGLE-EYE 追 source-to-sink,STRIKE 对每条发现先实测再上报。

    • mcp-server
    • security
    • pentest
    • methodology
  • Ripwire

    MCP 服务器

    Red Hat 出品的「AI 上下文版 ripgrep」——C++23 零依赖 CLI,同时讲 MCP。

    • mcp
    • code-context
    • cli
    • red-hat
  • Deja Vu

    MCP 服务器

    让 25+ 个编码 agent 共享同一份会话记忆——Claude Code、Codex、Cursor 终于记得同一个项目。

    • mcp
    • memory
    • cross-agent
    • context