학생 관리 MCP 프로토타입

목표

"학생 성장 프로필과 능동적 지원 폐쇄 루프" 시나리오를 대상으로, 에이전트 플랫폼에 이미 연동된 MCP 도구 세트를 제공하여 에이전트가 학생 프로필을 조회하고, 관심 명단을 필터링하며, 지원 태스크를 생성하고 추적하고, 지원 기록을 작성하고, 학급 대시보드를 생성하고 DingTalk 그룹에 연동할 수 있게 합니다.

Related MCP server: TeacherAssist-MCP

주요 특징

• "질의응답식 학생 관리"에서 "데이터 기반 능동적 발견"으로 업그레이드.

• 출석, 성적, 기숙사 피드백, 실습 성과, 지원 상태, 상담 기록을 종합하여 학생 성장 프로필 생성.

• "오늘 관심 필요 명단" 생성 지원으로 학생 관리가 수동 대응에서 능동 경고로 전환됨을 반영.

• 지원 기록 작성 지원으로 "문제 발견-제안 제시-후속 이행-기록 환류"의 폐쇄 루프 형성.

• 학급 대시보드 데이터 생성 가능, 대회 발표 시연에 적합.

도구 목록

로컬 실행

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
  }
}

플랫폼 연동 제안

플랫폼 실측에서 두 가지 진입 방식을 지원합니다:

1. MCP 서비스 수동 생성

   • 서비스 이름

   • 설명

   • 연결 방식: sse

   • 인터페이스 주소

   • Header 설정

   • 테스트 연결 클릭

2. JSON에서 가져오기

   • 형식은 mcpServers

   • 예시는 mcp_servers.example.json 참조

현재 SSE MCP 서비스는 Render에 배포되어 있으며, 플랫폼은 /sse 주소를 통해 도구를 발견하고 호출합니다. 로컬 127.0.0.1은 개발 검증용으로만 사용되며, 플랫폼의 공개 연동 주소로 사용할 수 없습니다.