xiaoya-teacher-mcp-server

# 小雅教育管理MCP服务器     专为教师设计的小雅智能教学平台教育管理 MCP 服务器。通过 MCP 与 AI 助手集成，提供课程资源管理、Markdown 富文本题目创建、试卷配置、班级查询、签到统计、任务测验与学生答卷批阅等能力。 默认安装包含常用文档转换依赖，适合本地 editable、`uv tool` 和标准发布包。 ## ✨ 核心特性 ### 🎯 AI助手集成 - **MCP协议支持** - 完美集成到支持MCP的AI助手(如Claude Desktop、Cursor等) - **多种传输方式** - 支持stdio、SSE、Streamable HTTP传输协议 - **摘要优先查询** - 题目、资源、任务默认返回摘要, 减少 AI token 消耗 - **统一响应格式** - 标准化的API响应, 便于AI助手解析和展示 ### 📚 智能题库系统 - **7种题型支持** - 单选题、多选题、填空题、判断题、简答题、附件题、编程题 - **富文本编辑** - 支持题目描述的富文本格式(粗体、斜体、下划线、代码块等) - **智能评分** - 填空题支持多种自动评分策略(精确匹配、部分匹配、有序/无序) - **批量操作** - 支持批量创建题目、官方导入题目、题目排序调整 ### 📁 资源管理系统 - **多类型资源** - 文件夹、笔记、思维导图、文件、作业、教学设计 - **完整生命周期** - 创建、删除、重命名、移动、排序、权限管理 - **文件处理** - 文件下载、markdown格式转换 - **树形结构** - 清晰的资源层级展示 ### 👥 班级与签到 - **班级管理** - 班级信息查询、学生统计 - **签到系统** - 签到记录查询、学生签到详情、多种签到状态 - **数据统计** - 出勤率分析、签到趋势 ### 📋 任务与测验 - **任务查询** - 查询课程组已发布任务列表、任务详情 - **成绩管理** - 学生答题情况统计、成绩分析 - **答题分析** - 学生答题详情预览、题目解析 - **AI 批阅** - 按学生打包整张答卷和附件，本地缓存图片/PDF/文件，支持多题分数与评语一次写入并提交；已提交批阅可确认后重开修改 ## 🆕 附件下载行为变更（v1.5.2） - `get_answer_file` 已从 `file_access` 预览端点切换为 `file_down/v2` 真实下载链路，避免将网页预览当作附件内容。 - 新增 HTML 负载识别：当响应为 HTML 预览页时，接口会返回结构化错误，不会把伪文件写入附件缓存。 - 本地附件缓存新增 HTML 伪缓存跳过逻辑：如果历史缓存命中 HTML 内容，会自动忽略并重新下载真实文件。 ## 🚀 快速开始 ### 发布安装 ```bash # 使用 uvx 直接运行 uvx xiaoya-teacher-mcp-server ``` ### 本地开发安装 ```bash git clone https://github.com/Sav1ouR520/xiaoya-teacher-mcp-server.git cd xiaoya-teacher-mcp-server # 安装开发依赖 uv sync --dev # 运行服务器 uv run xiaoya-teacher-mcp-server ``` ### 本机工具安装 ```bash # 将当前仓库安装为本机可执行 MCP 命令 uv tool install -e --reinstall . ``` ## ⚙️ 配置说明 ### 认证配置 服务器支持两种认证方式,本地(stdio)与远程(SSE/HTTP)均可使用。账号密码模式支持自动登录和 token 缓存；Bearer Token 模式只使用调用方提供的 token。 #### 方式一：账号密码自动登录(推荐,支持多账号远程缓存) 本地(stdio)和远程(SSE/HTTP)均可通过账号密码自动登录,token 会自动缓存,远程多账号也会自动保存。若请求过程中检测到认证过期,服务端会自动重新登录一次并重试当前请求. …