学生管理 MCP プロトタイプ

目標

「学生成長プロフィールと能動的支援クローズドループ」のシナリオに向けて、エージェントプラットフォームに接続済みの一連の MCP ツールを提供します。エージェントが学生プロフィールを照会し、要注意リストを絞り込み、支援タスクを作成・追跡し、支援記録を書き込み、クラスダッシュボードを生成し、DingTalk グループと連携できるようにします。

Related MCP server: TeacherAssist-MCP

ハイライト

• 「Q&A型の学生管理」から「データ駆動型の能動的発見」へアップグレード。

• 出席、成績、寮フィードバック、実習パフォーマンス、奨学金状態、面談記録を統合して学生成長プロフィールを構成。

• 「本日要注意リスト」の生成をサポートし、学生管理を受動的対応から能動的アラートへと転換。

• 支援記録の書き込みをサポートし、「問題発見-提案提示-フォローアップ実行-記録フィードバック」のクローズドループを形成。

• クラスダッシュボードデータを生成可能で、コンテスト発表デモに適しています。

ツール一覧

ローカル実行

cd D:\教育信息技术应用大赛\学生管理MCP原型
python -m uvicorn student_management_mcp_api:app --host 127.0.0.1 --port 8765

公網デプロイとエージェントプラットフォームでは student_management_mcp_sse:app を使用しています。ローカル検証では以下を実行できます：

python -m uvicorn student_management_mcp_sse:app --host 127.0.0.1 --port 8000

データ永続化

• DATABASE_URL を設定すると PostgreSQL を使用し、ソース台帳の取込、タスク、フォローアップ記録、監査台帳が Render 再デプロイ後も保持されます。

• 未設定の場合は自動的に .data/student_management.db のローカル SQLite を使用します。開発テストに適していますが、Render 再デプロイ後に失われる可能性があります。

• データベースを初めて有効化すると、リポジトリ内の followup_records.json と support_tasks.json の基本データが自動的にマイグレーションされます。

• 初回デプロイ時には 演示業務源文件 内の Excel 5 部、Word 1 部、PDF 1 部を読み取り、コンテストデモ用名簿、出席・学業、実習、スクリーニング提案、面談、タスク、実習室リソース予約台帳を正規化してデータベースに書き込みます。以降、MCP で新規追加された面談とタスクは累積され続けます。

• ヘルスチェック /health はストレージタイプと記録数を返しますが、データベースアドレスや DingTalk シークレットは返しません。

PostgreSQL 接続変数の例：

DATABASE_URL=postgresql://用户名:密码@主机:5432/数据库名

デモデータ保守

演示業務源文件 内はすべてコンテストデモ用の模擬データであり、実在の個人には対応しません。推奨される録画のメインラインは以下の通りです：

工作人员维护 Excel / Word / PDF 台账
  -> 服务自动解析并入库 PostgreSQL
  -> 班级态势与学生成长时间线
  -> 生成帮扶任务并回写谈话记录
  -> 按期复访提醒与任务审计
  -> 按日期、时段、容量和设备条件查询可用实训室

まず get_data_ingestion_status を呼び出してファイル、取込数、データパイプラインを表示し、その後ロールに応じて制御付き照会ツールを呼び出します：

• get_authorized_student_growth_timeline：学生は本人のみ、担任と指導員は権限のあるクラスのみ。

• get_authorized_class_operational_records：担任と指導員は権限のあるクラスの動態を閲覧、行政担当者は匿名集計のみ。

• list_authorized_followup_reminders：担任と指導員は権限範囲内の再訪待ち事項を閲覧。

ベースラインデータの復元：

python demo_data_maintenance.py --mode baseline --confirm RESET-DEMO-DATA

固定デモタスク 2 件を生成：

python demo_data_maintenance.py --mode sample --confirm RESET-DEMO-DATA

このスクリプトは現在のタスクと監査台帳をクリーンアップするため、保守担当者のみが録画準備段階で使用できます。MCP ツールではなく、DingTalk メッセージも送信しません。

呼び出し例

学生プロフィールの照会：

{
  "tool": "get_student_profile",
  "arguments": {
    "query": "S004"
  }
}

要注意リストの照会：

{
  "tool": "list_attention_students",
  "arguments": {}
}

支援記録の書き込み：

{
  "tool": "create_followup_record",
  "arguments": {
    "student_id": "S002",
    "owner": "辅导员",
    "summary": "已完成首次谈心，学生反馈近期课程压力较大，实训日志补交意识不足。",
    "next_action": "联系实训指导教师确认补交要求，三天后复访。",
    "status": "跟进中"
  }
}

クラスダッシュボードの生成：

{
  "tool": "get_class_dashboard",
  "arguments": {
    "class_name": "智能制造2401"
  }
}

支援タスクの作成（デフォルトではプッシュなし）：

{
  "tool": "create_student_support_task",
  "arguments": {
    "student_query": "S004",
    "owner": "辅导员",
    "due_date": "2026-07-18",
    "push_to_dingtalk": false
  }
}

タスク完了と支援記録の同期：

{
  "tool": "update_student_support_task",
  "arguments": {
    "task_id": "任务编号",
    "status": "已完成",
    "progress_note": "已完成线下谈心。",
    "next_action": "联系任课教师并于一周后复访。",
    "sync_followup": true
  }
}

プラットフォーム接続の提案

プラットフォームでは 2 つのエントリ方法が実測でサポートされています：

1. MCP サービスを手動作成

   • サービス名

   • 説明

   • 接続方式：sse

   • インターフェースアドレス

   • Header 設定

   • テスト接続をクリック

2. JSON からインポート

   • 形式は mcpServers

   • 例は mcp_servers.example.json を参照

現在の SSE MCP サービスは Render にデプロイされており、プラットフォームは /sse アドレスを通じてツールを発見・呼び出しします。本機の 127.0.0.1 は開発検証専用であり、プラットフォームの公網接続アドレスとしては使用できません。