Moodle MCP Server

🚀 Moodle MCP 服務器

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

安裝步驟

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

📚 詳細文檔

開發

要進行開發，請按照以下步驟操作：

1. 克隆此倉庫
2. 安裝依賴項（如上所述）
3. 在終端中運行 npm run dev 開始開發服務器

調試

要進行調試，請使用 MCP Inspector：

npx mcp-inspect .

在瀏覽器中訪問 http://localhost:8090 查看文檔。

安全性

• 確保 API 令牌的安全，不要將其公開
• 使用 HTTPS 在生產環境中保護通信
• 定期更新軟件以防止安全漏洞

📄 許可證

該項目受 MIT 許可證的約束。請參閱 LICENSE 瞭解詳細信息。