MCP

🚀 Moodle MCP Server

Moodle MCP Serverは、LLM（大規模言語モデル）がMoodleプラットフォームと相互作用し、コース、学生、課題、クイズを管理できるようにするMCP（Model Context Protocol）サーバーです。

✨ 主な機能

学生管理ツール

• 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サーバーはstdioを介して通信するため、デバッグが難しい場合があります。私たちはMCP Inspectorの使用をお勧めします：

npm run inspector

InspectorはブラウザでデバッグツールにアクセスするためのURLを提供します。

Moodle APIトークンの取得方法

1. 管理者としてあなたのMoodleサイトにログインします。
2. サイト管理 > プラグイン > Webサービス > トークンの管理に移動します。
3. コースを管理するために必要な権限を持つ新しいトークンを作成します。
4. 生成されたトークンをコピーし、.envファイルに追加します。

⚠️ 重要提示

.envファイルやMoodle APIトークンを決して共有しないでください。

💡 使用建议

MCPサーバーが管理する必要のあるコースのみにアクセスできるようにし、必要最小限の権限を持つトークンを使用してください。

📄 ライセンス

MIT