Skip to main content
Glama
deenesjakoruzh
zuckdorsey

moodle-mcp

by zuckdorsey
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

moodle-mcp

Moodle LMS 的模型上下文协议服务器 — 连接 Hermes、Claude Code 和 OpenCode 到你的 Moodle。获取作业、成绩和截止日期，同步到 Obsidian，并接收 WhatsApp 提醒。

Python MCP 许可证: MIT

概述 • 功能 • 快速开始 • 配置 • 代理设置 • 工具 • Obsidian 同步

概述

moodle-mcp 将 Moodle Web 服务 API 与模型上下文协议桥接，使 AI 代理能够充当你的学术助手。它专为 Polibatam（多班级过滤）构建，但适用于任何启用了 Web 服务的 Moodle 实例。

loyaniu/moodle-mcp 的分支 — 从 22 个工具扩展到 40 个，增加了 Obsidian 同步、资料下载、提交工具、日历集成、并发获取和学期自动归档。

[!TIP] 适用于任何 Moodle LMS — 只需将 MOODLE_URL 指向你的实例。Polibatam 班级过滤器（MOODLE_MY_CLASS）是可选的。

Related MCP server: mcp-moodle

功能

  • 作业与截止日期 — 按班级时段过滤，按紧急程度排序，附带可操作任务列表

  • 成绩与进度 — 课程健康检查、学习负荷和完成度追踪

  • 课程内容与搜索 — 章节、模块、资料、公告、近期活动

  • Obsidian 同步 — 一键导出仪表盘、截止日期和课程笔记（支持学期自动归档）

  • 资料下载 — 列出并下载课程文件和作业附件

  • 提交 — 提交文本、检查状态和阅读反馈

  • 日历 — 即将到来的事件，创建提醒（H-2），标记活动完成

  • 代理就绪 — 单个 install-mcp.sh 适用于 Hermes、Claude Code 和 OpenCode

快速开始

一键安装

curl -fsSL https://raw.githubusercontent.com/zuckdorsey/moodle-mcp/main/scripts/install-mcp.sh | bash

自动检测已安装的代理并配置每个代理。如需试运行：

bash scripts/install-mcp.sh --dry-run

验证

# Hermes (profile: akademik)
hermes --profile akademik mcp test moodle
# → ✓ Connected  ✓ Tools discovered: 40

# Claude Code
claude mcp list

# Run tests
PYTHONPATH=src .venv/bin/python -m unittest discover -s tests -v

[!NOTE] 开发时优先使用本地源码而非 PyPI — 启动器会自动将 PYTHONPATH 设置为 src/。

配置

1. 获取你的 Moodle 令牌

  1. 打开 https://<你的-moodle>/user/managetoken.php

  2. 在 服务 列中找到 Moodle 移动端 Web 服务 所在行

  3. 复制该令牌

2. 创建 .env

cp .env.example .env
MOODLE_URL=https://your-moodle.example.com/webservice/rest/server.php
MOODLE_TOKEN=your_token_here

# Optional — Polibatam class-slot filter (e.g. Pagi C, Siang A)
MOODLE_MY_CLASS=Pagi C

# Optional — custom vault path
OBSIDIAN_VAULT_PATH=/home/you/Obsidian Vault

变量

必需

描述

MOODLE_URL

是

Moodle REST 端点（.../webservice/rest/server.php）

MOODLE_TOKEN

是

移动端 Web 服务令牌

MOODLE_MY_CLASS

否

多班级作业标题的正则过滤器

OBSIDIAN_VAULT_PATH

否

知识库根目录（默认：~/Obsidian Vault）

3. 安装包

# with uv (recommended)
uv pip install -e .

# or pip
pip install -e .

[!WARNING] 切勿提交 .env — 它包含具有完整 API 访问权限的令牌。该文件已在 .gitignore 中。

代理设置

选择你的代理 — 所有代理都使用相同的本地启动器 scripts/moodle_mcp_local_launch.py。

Hermes 代理（推荐）

bash scripts/install-mcp.sh --agent hermes --profile akademik

手动配置（~/.hermes/profiles/akademik/config.yaml）：

mcp_servers:
  moodle:
    command: /home/you/Programming/Python/moodle-mcp/.venv/bin/python
    args: [/home/you/Programming/Python/moodle-mcp/scripts/moodle_mcp_local_launch.py]
    env:
      MOODLE_URL: ${MOODLE_URL}
      MOODLE_TOKEN: ${MOODLE_TOKEN}
      MOODLE_MY_CLASS: "Pagi C"
      OBSIDIAN_VAULT_PATH: "/home/you/Obsidian Vault"

Claude Code

bash scripts/install-mcp.sh --agent claude-code
# or manually
claude mcp add -s user moodle-mcp -- python3 /path/to/moodle-mcp/scripts/moodle_mcp_local_launch.py

全局 JSON（~/.claude/settings.json）：

{
  "mcpServers": {
    "moodle-mcp": {
      "command": "python3",
      "args": ["/path/to/moodle-mcp/scripts/moodle_mcp_local_launch.py"],
      "env": {
        "MOODLE_URL": "https://your-moodle/webservice/rest/server.php",
        "MOODLE_TOKEN": "your_token_here"
      }
    }
  }
}

OpenCode

bash scripts/install-mcp.sh --agent opencode

~/.config/opencode/config.json：

{
  "mcp": {
    "moodle-mcp": {
      "command": "python3",
      "args": ["/path/to/moodle-mcp/scripts/moodle_mcp_local_launch.py"],
      "environment": {
        "MOODLE_URL": "https://your-moodle/webservice/rest/server.php",
        "MOODLE_TOKEN": "your_token_here"
      }
    }
  }
}

Claude Desktop / Cursor

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "moodle-mcp": {
      "command": "uvx",
      "args": ["moodle-mcp"],
      "env": {
        "MOODLE_URL": "https://your-moodle/webservice/rest/server.php",
        "MOODLE_TOKEN": "your_token_here"
      }
    }
  }
}

重启桌面应用 — 工具将出现在选择器中。

工具

40 个工具，分为 7 组。通过名称从任何连接的代理调用它们（例如 "列出我的 Moodle 课程" → get_my_courses）。

工具

描述

get_my_courses

已注册的课程

get_course_content

课程的章节与模块

search_course_materials

搜索所有资料

get_course_announcements

新闻论坛公告

get_recent_activity

自时间戳以来的近期活动

get_course_updates

新资料/公告

工具

描述

get_assignments

作业（按班级时段过滤）

get_assignment_status

提交与评分状态

get_upcoming_deadlines

按截止日期排序的截止日期

get_overdue_assignments

逾期未提交的作业

get_actionable_tasks

按优先级排序的紧急任务列表

analyze_assignment

状态 + 要求 + 资料

extract_assignment_requirements

交付物与标准

find_relevant_materials

与作业相关的内容

decompose_task

包含关键路径的子任务

create_implementation_plan

时间线、资源、里程碑

submit_assignment_text

提交文本答案

get_assignment_feedback

反馈与评分标准结果

工具

描述

get_grades

概览或按课程查看详情

get_course_progress

完成进度

get_course_health

健康检查（进度 + 成绩 + 逾期）

get_study_load

按周分配的作业分布

get_submission_status_detail

详细的提交与反馈信息

工具

描述

get_upcoming_events

即将到来的 Moodle 事件

create_calendar_event

创建 H-2 提醒

get_activity_completion

完成状态

mark_activity_complete

标记活动完成

工具

描述

semester_dashboard

课程 + 截止日期 + 成绩

daily_briefing

逾期、今日、近期成绩

weekly_review

已提交、已评分、逾期、进度

ask_moodle

自然语言路由

get_course_updates

课程变更检测

工具

描述

sync_moodle_to_obsidian

完整知识库同步（学期轮换时自动归档）

export_deadlines_to_obsidian

仅导出截止日期

export_course_outline

导出课程大纲为笔记

list_course_material_files

列出可下载的文件

download_course_materials

下载到 Materials/ 目录

download_assignment_attachments

下载作业文件

[!TIP] 试试："这周有什么作业？" → get_upcoming_deadlines，"分析数据库作业" → analyze_assignment，"同步到 Obsidian" → sync_moodle_to_obsidian。

Obsidian 同步

同步会在你的知识库中 Academic/Moodle 目录下创建笔记：

Obsidian Vault/Academic/
  Moodle/                    ← current semester (always up-to-date)
    .semester_courses.json   ← hidden state (course IDs)
    Dashboard.md
    Deadlines.md
    Grades.md
    Courses/
  Archive/
    Semester-2026-07/        ← auto-created on rollover
      Dashboard.md
      Courses/
      Archive-README.md

学期自动归档 在超过 50% 的课程 ID 发生变化（或全部为新课程）时触发。单个课程交换将被忽略。

PYTHONPATH=src python - <<'PY'
from moodle_mcp import api
print(api.sync_moodle_to_obsidian())
PY

安全说明

[!CAUTION] 你的 Moodle 令牌以你的用户身份授予完整的 API 访问权限。请像对待密码一样对待它。

  • 令牌在服务器端加载，永远不会发送给模型。

  • 在 CI 中将 MOODLE_URL / MOODLE_TOKEN 作为环境机密注入。

  • moodle.py 使用类似浏览器的 User-Agent + POST 以实现 Cloudflare 兼容性。

致谢

loyaniu/moodle-mcp 的分支 — 感谢所有原始贡献者：

贡献者

角色

Zhonglin Niu

原作者，Moodle REST 集成，核心服务器

Vitalii Liudvynskyi

仪表盘、学习负荷、健康检查

Daniel Sticker

课程内容与搜索修复

Lawrence Sinclair

安全评估徽章

本分支新增功能

  • Obsidian 同步 + 学期自动归档

  • 资料下载与作业附件

  • 提交与反馈工具、日历与完成度

  • Polibatam 班级时段过滤器（MOODLE_MY_CLASS）

  • 并发获取（可操作任务速度提升约 10 倍）

  • 通用 install-mcp.sh，适用于 Hermes / Claude Code / OpenCode

This server cannot be installed

F
license - not found
-
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • agentbay-mcp

    Persistent memory and knowledge management for AI agents with semantic search and 50+ tools.

  • Hint-Services-obsidian-github-mcp

    Connect AI assistants to your GitHub-hosted Obsidian vault to seamlessly access, search, and analy…

  • socialclaw

    Connect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/zuckdorsey/moodle-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server