Peancor Moodle MCP Server

🚀 Moodle MCP サーバー

MCP（モデルコンテキストプロトコル）サーバーです。大型言語モデルが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_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 ファイルを参照してください。