Moodle-MCP

Moodle-MCP

一种模型上下文协议（MCP）服务实现，提供与 Moodle LMS 交互的功能。

功能

该服务提供以下工具。

课程与内容

工具	描述
get_my_courses	获取当前用户选修的所有课程
get_course_content	根据课程 ID 获取指定课程的章节和模块
search_course_materials	根据查询字符串搜索所有课程资料
get_course_announcements	获取课程新闻论坛中的公告，可按课程 ID 筛选
get_recent_activity	获取自指定时间以来各课程的近期活动和更新

作业与截止日期

工具	描述
get_assignments	获取课程作业，可按课程 ID 筛选
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	制定分步骤计划，包含时间线、资源、里程碑和风险

成绩与进度

工具	描述
get_grades	获取所有课程的成绩概览，或某门课程的详细成绩
get_course_progress	获取一门或所有课程的进度和完成情况
get_course_health	检查课程状况：进度、成绩、未提交和逾期数量
get_study_load	按周分析作业分布，以识别任务繁重的周

汇总概览

工具	描述
get_upcoming_events	获取 Moodle 中的近期活动
semester_dashboard	汇总课程、近期截止日期和成绩
daily_briefing	每日摘要，包含逾期数量、今日截止事项、近期成绩、活动和任务
weekly_review	每周摘要，包含已提交/已评分数量、截止事项、逾期数量和进度
ask_moodle	用自然语言提问，并将问题路由到合适的数据源

API 参考

有关可用的 Moodle API 函数，请参阅官方文档。

设置说明

方法 1：使用 mcp CLI（推荐）

1. 根据 .env.example 创建自己的 .env 文件
2. 假设已安装 uv，运行 uv add "mcp[cli]" 安装 MCP CLI 工具
3. 运行 mcp install main.py -f .env，将 moodle-mcp 服务添加到 Claude 应用

方法 2：使用 uvx

前往 Claude > Settings > Developer > Edit Config > claude_desktop_config.json，并添加以下内容

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

身份验证

获取 Moodle 令牌

1. 前往 Moodle 令牌管理页面：https://{your-moodle-url}/user/managetoken.php
2. 使用 Service 列中对应 Moodle mobile web service 的令牌
3. 将此令牌添加到 .env 文件