核心功能
infinitecampus-mcp 是专为美国 K-12 学生家长设计的 MCP 服务,将 Infinite Campus Campus Parent 门户数据无缝接入 AI 对话。通过标准化的工具集,家长可实时获取子女的学业全貌:从课程成绩、近期评分、作业清单到考试成绩;从出勤记录、缺勤详情到校历日程;从行为记录、待缴费用到餐卡余额;甚至包括教师联系信息、站内消息收发及学校文档下载。
显著优势
家长场景深度定制:工具命名与功能设计完全贴合家长日常关切,如 ic_list_recent_grades 快速定位最新评分,ic_list_behavior 一键掌握纪律动态,无需在海量数据中手动筛选。
双轨认证灵活适配:支持传统用户名密码认证,也创新提供 fetchproxy 浏览器 Cookie 回退方案——家长先在浏览器完成登录,MCP 自动读取会话状态,避免在配置文件中存储敏感凭证,兼顾便利与安全。
零配置自动发现:通过 CUPS(Campus Unified Portal Services)自动探测门户布局,覆盖绝大多数学区,家长仅需提供基础 URL 和学区代码即可启用。
局限与风险
地理局限性:仅适用于采用 Infinite Campus 的美国 K-12 学区,对全球其他教育系统(如中国学籍系统、欧洲 Moodle 平台)无兼容性。
认证安全隐患:用户名密码方案以明文环境变量存储,存在配置文件泄露风险;fetchproxy 方案虽避免密码存储,但依赖浏览器扩展的维护与更新。
数据实时性依赖:作为第三方封装,若 Infinite Campus 官方 API 变更或学区门户结构特殊,可能出现数据同步延迟或解析失败。
适合人群
- 需要频繁追踪子女学业进展的忙碌家长
- 希望集中管理多子女、多维度教育数据的用户
- 熟悉 Node.js/npm 生态、具备基础配置能力的技术型家长
常规风险提示
- 凭证管理:优先使用 fetchproxy 方案,避免在共享环境或版本控制中暴露
IC_PASSWORD - 隐私边界:AI 对话中的学生数据可能留存于上下文,建议在敏感查询后清理会话
- 学区差异:部分学区可能启用非标准门户布局,需验证
IC_BASE_URL与IC_DISTRICT的准确性