{"id":"xiaoya-teacher-mcp-server","name":"xiaoya-teacher-mcp-server","homepage":"https://pypi.org/project/xiaoya-teacher-mcp-server/","repo_url":"https://github.com/Sav1ouR520/xiaoya-teacher-mcp-server","category":"ai-ml","subcategories":[],"tags":["mcp","education","teacher-tools","questions","resources","attendance","grading","python"],"what_it_does":"This package provides a Python-based MCP server for “Xiaoya” (小雅) education management, exposing tools for teacher-oriented workflows such as course resource management, question/quiz creation and management, classroom & attendance (签到) queries, and task/assignment + grading workflows. It supports multiple MCP transports (stdio by default, plus SSE and streamable HTTP). Authentication to the upstream service can be done either via account/password (with server-side token caching and automatic re-login) or via a provided Bearer token.","use_cases":["Integrate an AI assistant with Xiaoya education management via MCP tools","Create and manage question banks (multiple question types, rich text, batch operations)","Manage course resources and files (create/update/delete, download, markdown conversion)","Query classroom info and attendance/签到 statistics","Publish tasks/quizzes, review submissions, and record grades/feedback"],"not_for":["Production-grade classroom systems requiring a documented SLA, rigorous operational guarantees, and comprehensive security hardening","Environments where you cannot securely handle account/password or tokens (especially over HTTP)","Use cases that need a stable, documented public REST/GraphQL/OpenAPI API for long-term machine integration"],"best_when":"You want an MCP integration path for an AI assistant (e.g., Claude Desktop/Cursor) to automate teacher management tasks, and you can run the MCP server locally or in a controlled network with the specified authentication approach.","avoid_when":"You need fine-grained authorization controls per tool/user, strong secrets-handling guarantees (beyond what’s described), or you can’t tolerate beta-stage software with limited evidence of robustness/testing.","alternatives":["Other MCP servers or integrations for education platforms that expose REST/GraphQL APIs with stronger published contracts","Direct integration to an education platform’s native API (if available) instead of MCP"],"af_score":60.8,"security_score":49.2,"reliability_score":32.5,"package_type":"mcp_server","discovery_source":["pypi"],"priority":"low","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-04-04T21:38:00.585215+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":["Python"],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["Account/password (auto login with token caching; automatic re-login on expiry for in-flight requests)","Bearer token (direct authentication; no auto re-login)","HTTP headers for remote transport: X-XIAOYA-ACCOUNT/X-XIAOYA-PASSWORD or Authorization: Bearer <token>"],"oauth":false,"scopes":false,"notes":"No OAuth is described. Authentication is described at the MCP transport boundary using environment variables for stdio and HTTP headers for remote transports. Fine-grained scopes/permissions are not documented."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing information is provided; this appears to be a self-hosted open-source Python package (MIT)."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":60.8,"security_score":49.2,"reliability_score":32.5,"mcp_server_quality":80.0,"documentation_accuracy":65.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":70.0,"rate_limit_clarity":20.0,"tls_enforcement":70.0,"auth_strength":60.0,"scope_granularity":20.0,"dependency_hygiene":55.0,"secret_handling":40.0,"security_notes":"HTTPS/TLS enforcement is not explicitly stated in the README (remote transports show HTTP examples). Authentication supports account/password and bearer tokens; account/password mode implies token caching, and bearer mode does not auto-refresh. No evidence of fine-grained authorization scopes per tool is documented. Secrets handling details (e.g., whether credentials/tokens are ever logged) are not specified, so this score is conservative. Dependency list is small and bounded versions are suggested, but no vulnerability posture is documented.","uptime_documented":0.0,"version_stability":45.0,"breaking_changes_history":30.0,"error_recovery":55.0,"idempotency_support":"false","idempotency_notes":"No explicit idempotency guarantees for create/update/grade operations are described.","pagination_style":"none","retry_guidance_documented":true,"known_agent_gotchas":["Token-expiry handling differs by auth mode: account/password mode may auto re-login and retry once; Bearer-token mode requires the caller to refresh and retry.","Remote HTTP transports accept credentials via headers; ensure clients are configured to avoid leaking credentials in logs.","Default behavior returns summaries to save tokens; requesting full details may increase response size and latency."]}}