MCP 服务器

Moodle MCP Server

一个 MCP 服务器，它使大型语言模型 (LLM) 能够与 Moodle 平台交互，并通过自然语言命令来管理课程、学生、作业和测验。

README

Moodle MCP 服务器

一个 MCP (模型上下文协议) 服务器，使 LLM 能够与 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

安装

克隆此存储库：

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

安装依赖项：

npm install

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

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

构建服务器：

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": []
    }
  }
}