MCP

🚀 Moodle MCP 服務器

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 服務器通過標準輸入輸出進行通信，這可能會使調試變得困難。我們建議使用 MCP Inspector：

npm run inspector

Inspector 會提供一個 URL，你可以在瀏覽器中訪問調試工具。

獲取 Moodle API 令牌

1. 以管理員身份登錄到你的 Moodle 網站
2. 進入網站管理 > 插件 > 網絡服務 > 管理令牌
3. 創建一個具有管理課程所需權限的新令牌
4. 複製生成的令牌，並將其添加到你的 .env 文件中

🔧 技術細節

安全注意事項

• 切勿共享你的 .env 文件或 Moodle API 令牌
• 確保 MCP 服務器僅能訪問其需要管理的課程
• 使用具有最低必要權限的令牌

📄 許可證

本項目採用 MIT 許可證。