Moodle MCP 服务器

一个MCP（模型上下文协议）服务器，使LLMs能够与Moodle平台交互以管理课程、学生、作业和测验。

功能

学生管理工具

• list_students - 获取课程中注册的学生列表
  • 显示每个学生的ID、姓名、电子邮件地址和最后访问时间

作业管理工具

• get_assignments - 获取课程中的所有可用作业
  • 包括ID、名称、描述、截止日期和最高分数等信息
• get_student_submissions - 检查特定作业的学生提交情况
  • 需要作业ID，可选学生ID
• provide_assignment_feedback - 为学生的作业提交提供评分和评论
  • 需要学生ID、作业ID、评分和反馈评论

测验管理工具

• get_quizzes - 获取课程中的所有可用测验
  • 包括ID、名称、描述、开放/关闭日期和最高分数等信息
• get_quiz_attempts - 检查特定测验的学生尝试情况
• 需要测验ID，可选学生ID
• provide_quiz_feedback - 为测验尝试提供评论
  • 需要尝试ID和反馈评论

要求

• Node.js（v14或更高版本）
• 具有适当权限的Moodle API令牌
• Moodle课程ID

安装

1. 克隆此仓库：

git clone https://github.com/your-username/moodle-mcp-server.git
cd moodle-mcp-server

2. 安装依赖项：

npm install

3. 创建一个包含以下配置的.env文件：

MOODLE_API_URL=https://your-moodle.com/webservice/rest/server.php
MOODLE_API_TOKEN=your_api_token
MOODLE_COURSE_ID=1  # 替换为您的课程ID

4. 构建服务器：

npm run build

使用Claude

要在Claude Desktop中使用，请添加服务器配置：

在MacOS上：~/Library/Application Support/Claude/claude_desktop_config.json
在Windows上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "moodle-mcp-server": {
      "command": "/path/to/node",
      "args": [
        "/path/to/moodle-mcp-server/build/index.js"
      ],
      "env": {
        "MOODLE_API_URL": "https://your-moodle.com/webservice/rest/server.php",
        "MOODLE_API_TOKEN": "your_moodle_api_token",
        "MOODLE_COURSE_ID": "your_course_id"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

对于Windows用户，路径会使用反斜杠：

{
  "mcpServers": {
    "moodle-mcp-server": {
      "command": "C:\\path\\to\\node.exe",
      "args": [
        "C:\\path\\to\\moodle-mcp-server\\build\\index.js"
      ],
      "env": {
        "MOODLE_API_URL": "https://your-moodle.com/webservice/rest/server.php",
        "MOODLE_API_TOKEN": "your_moodle_api_token",
        "MOODLE_COURSE_ID": "your_course_id"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

配置完成后，Claude将能够与您的Moodle课程进行交互以：

• 查看学生列表及其提交情况
• 为作业提供评论和评分
• 检查测验尝试并提供反馈

开发

为了开发时自动重建：

npm run watch

调试

MCP服务器通过标准I/O进行通信，这可能使得调试具有挑战性。我们建议使用MCP Inspector：

npm run inspector

Inspector将提供一个URL，以便您可以在浏览器中访问调试工具。

获取Moodle API令牌

1. 以管理员身份登录到您的Moodle站点
2. 前往站点管理 > 插件 > 网络服务 > 管理令牌
3. 创建一个新的具有管理课程所需权限的令牌
4. 复制生成的令牌，并将其添加到您的.env文件中

安全

• 切勿分享您的.env文件或Moodle API令牌
• 确保MCP服务器仅访问其需要管理的课程
• 使用具有最低必要权限的令牌

许可证

MIT