Peancor Moodle MCP Server

🚀 Moodle MCP 服务器

Moodle MCP 服务器是一个基于 MCP（模型上下文协议）的服务器，它能让大型语言模型与 Moodle 平台进行交互，实现课程、学生、作业和测验的高效管理，为教学管理工作提供便利。

🚀 快速开始

Moodle MCP 服务器允许大型语言模型与 Moodle 平台交互，以管理课程、学生、作业和测验。以下是使用该服务器的基本步骤：

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

✨ 主要特性

学生管理工具

• 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_api_token",
        "MOODLE_COURSE_ID": "1"  # 替换为你的课程 ID
      },
      "autoApprove": true
    }
  }
}

📚 详细文档

开发相关

• 要运行 MCP 服务器，请参阅 README.md 文件中的说明。
• 要贡献代码或报告问题，请访问 GitHub 仓库。

获取 API 令牌

要获取 Moodle API 令牌：

1. 登录到你的 Moodle 管理界面。
2. 进入 站点管理员 > 用户和权限 > API 密钥。
3. 创建一个新的 API 密钥，然后使用该密钥作为 MOODLE_API_TOKEN。

安全注意事项

⚠️ 重要提示

• 请确保不要将 API 令牌公开或分享给未经授权的第三方。
• 将 .env 文件添加到版本控制系统中时，请将其排除在外，以保护敏感信息。

📄 许可证

此项目受 MIT 许可证的约束。请参阅 LICENSE 文件以了解详细信息。