{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_rkvsk49egy8b","handle":"xiaoya-teacher-mcp-server","url":"https://wellknown.network/agents/xiaoya-teacher-mcp-server","links":{"self":"https://wellknown.network/agents/xiaoya-teacher-mcp-server/record.json","html":"https://wellknown.network/agents/xiaoya-teacher-mcp-server","markdown":"https://wellknown.network/agents/xiaoya-teacher-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/xiaoya-teacher-mcp-server","status":"https://wellknown.network/api/v1/agents/xiaoya-teacher-mcp-server/status","claim":"https://wellknown.network/agents/xiaoya-teacher-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/xiaoya-teacher-mcp-server/claim.json","badge":"https://wellknown.network/agents/xiaoya-teacher-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:xiaoya-teacher-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"xiaoya-teacher-mcp-server","summary":"小雅教育管理MCP服务器 - 课程资源、Markdown富文本题目和学生答卷批阅工具","description":"# 小雅教育管理MCP服务器\n\n![版本](https://img.shields.io/badge/版本-1.5.1-blue)\n![Python](https://img.shields.io/badge/Python-3.11+-green)\n![MCP](https://img.shields.io/badge/MCP-1.26.0+-purple)\n![许可证](https://img.shields.io/badge/许可证-MIT-yellow)\n\n专为教师设计的小雅智能教学平台教育管理 MCP 服务器。通过 MCP 与 AI 助手集成，提供课程资源管理、Markdown 富文本题目创建、试卷配置、班级查询、签到统计、任务测验与学生答卷批阅等能力。\n\n默认安装包含常用文档转换依赖，适合本地 editable、`uv tool` 和标准发布包。\n\n## ✨ 核心特性\n\n### 🎯 AI助手集成\n- **MCP协议支持** - 完美集成到支持MCP的AI助手(如Claude Desktop、Cursor等)\n- **多种传输方式** - 支持stdio、SSE、Streamable HTTP传输协议\n- **摘要优先查询** - 题目、资源、任务默认返回摘要, 减少 AI token 消耗\n- **统一响应格式** - 标准化的API响应, 便于AI助手解析和展示\n\n### 📚 智能题库系统\n- **7种题型支持** - 单选题、多选题、填空题、判断题、简答题、附件题、编程题\n- **富文本编辑** - 支持题目描述的富文本格式(粗体、斜体、下划线、代码块等)\n- **智能评分** - 填空题支持多种自动评分策略(精确匹配、部分匹配、有序/无序)\n- **批量操作** - 支持批量创建题目、官方导入题目、题目排序调整\n\n### 📁 资源管理系统\n- **多类型资源** - 文件夹、笔记、思维导图、文件、作业、教学设计\n- **完整生命周期** - 创建、删除、重命名、移动、排序、权限管理\n- **文件处理** - 文件下载、markdown格式转换\n- **树形结构** - 清晰的资源层级展示\n\n### 👥 班级与签到\n- **班级管理** - 班级信息查询、学生统计\n- **签到系统** - 签到记录查询、学生签到详情、多种签到状态\n- **数据统计** - 出勤率分析、签到趋势\n\n### 📋 任务与测验\n- **任务查询** - 查询课程组已发布任务列表、任务详情\n- **成绩管理** - 学生答题情况统计、成绩分析\n- **答题分析** - 学生答题详情预览、题目解析\n- **AI 批阅** - 按学生打包整张答卷和附件，本地缓存图片/PDF/文件，支持多题分数与评语一次写入并提交；已提交批阅可确认后重开修改\n\n## 🆕 附件下载行为变更（v1.5.2）\n\n- `get_answer_file` 已从 `file_access` 预览端点切换为 `file_down/v2` 真实下载链路，避免将网页预览当作附件内容。\n- 新增 HTML 负载识别：当响应为 HTML 预览页时，接口会返回结构化错误，不会把伪文件写入附件缓存。\n- 本地附件缓存新增 HTML 伪缓存跳过逻辑：如果历史缓存命中 HTML 内容，会自动忽略并重新下载真实文件。\n\n## 🚀 快速开始\n\n### 发布安装\n```bash\n# 使用 uvx 直接运行\nuvx xiaoya-teacher-mcp-server\n```\n\n### 本地开发安装\n```bash\ngit clone https://github.com/Sav1ouR520/xiaoya-teacher-mcp-server.git\ncd xiaoya-teacher-mcp-server\n\n# 安装开发依赖\nuv sync --dev\n\n# 运行服务器\nuv run xiaoya-teacher-mcp-server\n```\n\n### 本机工具安装\n```bash\n# 将当前仓库安装为本机可执行 MCP 命令\nuv tool install -e --reinstall .\n```\n\n## ⚙️ 配置说明\n\n### 认证配置\n\n服务器支持两种认证方式,本地(stdio)与远程(SSE/HTTP)均可使用。账号密码模式支持自动登录和 token 缓存；Bearer Token 模式只使用调用方提供的 token。\n\n#### 方式一：账号密码自动登录(推荐,支持多账号远程缓存)\n本地(stdio)和远程(SSE/HTTP)均可通过账号密码自动登录,token 会自动缓存,远程多账号也会自动保存。若请求过程中检测到认证过期,服务端会自动重新登录一次并重试当前请求.\n…","publisher":null,"homepage":"https://github.com/Sav1ouR520/xiaoya-teacher-mcp-server","repository":"https://github.com/Sav1ouR520/xiaoya-teacher-mcp-server","version":"1.5.2","license":"MIT","protocols":["mcp"],"tags":["education","mcp","teacher","xiaoya"],"pricing":null,"endpoints":[{"url":"pypi:xiaoya-teacher-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"zh"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"xiaoya-teacher-mcp-server","registry":"pypi","observedAt":"2026-09-10T16:24:20.112Z","publishedAt":"2026-07-09T07:45:56.150430Z","latestVersion":"1.5.2"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"xiaoya-teacher-mcp-server","url":"https://pypi.org/project/xiaoya-teacher-mcp-server/","firstSeenAt":"2026-09-10T16:22:54.958Z","fetchedAt":"2026-09-10T16:22:54.958Z","normalizedAt":"2026-09-10T16:22:54.958Z"}]},"firstSeenAt":"2026-09-10T16:22:54.958Z","updatedAt":"2026-09-10T16:24:20.112Z"}