学校数据访问服务

通过MCP协议访问法国学校管理平台Pronote的学生数据(成绩、课表、作业等)的服务器。

  • by HAL-XP
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 HAL-XP/mcp-pronotes

使用说明

mcp前足类

Pronote的MCP服务器——从任何人工智能助手访问法语学校数据。


第一 模型上下文协议 服务器 发音 (Index Education),法国排名第一的学校管理平台 数百万学生和家长。将任何兼容MCP的AI助手连接到您的 孩子的学校数据:成绩、时间表、家庭作业、缺席、平均成绩和 餐厅菜单。

特性

工具 说明
get_timetable 每日或每周课程表(课程、房间、教师、取消)
get_grades 每个科目的平均成绩、最低成绩、最高成绩和系数
get_homework 即将完成的家庭作业,包括截止日期和完成状态
get_absences 特定时期的缺席、延误和惩罚
get_student_info 学生简介、班级、学校名称和可用时段
get_averages 学生、班级、最小值和最大值的科目平均值
get_menus 日期范围内的学校食堂菜单

所有工具支持 多子账户:通过 child_name 选择一个 特定子项,或省略它以默认为第一个子项。

快速开始

1.安装依赖项

pip install pronotepy "mcp>=1.20.0"

或者从需求文件中:

pip install -r requirements.txt

2.配置凭据

创建一个 config.json 在项目目录中:

{
  "pronote_url": "https://XXXX.index-education.net/pronote/mobile.parent.html",
  "username": "your_username",
  "password": "your_password",
  "account_type": "parent"
}

集 account_type 到 "student" 如果您使用学生帐户登录。

或者,使用环境变量(它们优先于 config.json):

export PRONOTE_URL="https://XXXX.index-education.net/pronote/mobile.parent.html"
export PRONOTE_USERNAME="your_username"
export PRONOTE_PASSWORD="your_password"
export PRONOTE_ACCOUNT_TYPE="parent"

3.用克劳德代码注册

claude mcp add pronotes -- python /path/to/mcp-pronotes/server.py

或者使用环境变量而不是config.json:

claude mcp add pronotes \
  -e PRONOTE_URL="https://XXXX.index-education.net/pronote/..." \
  -e PRONOTE_USERNAME="your_username" \
  -e PRONOTE_PASSWORD="your_password" \
  -- python /path/to/mcp-pronotes/server.py

服务器通过stdio进行通信,并与任何兼容MCP的客户端协同工作。

配置

服务器从两个源读取配置(环境变量覆盖 config.json):

来源 关键字 描述
config.json pronote_url 学校的完整发音URL
config.json username 您的Pronote用户名
config.json password 您的Pronote密码
config.json account_type "parent" 或 "student"
每个人都是。 PRONOTE_URL 覆盖范围 pronote_url
每个人都是。 PRONOTE_USERNAME 覆盖范围 username
每个人都是。 PRONOTE_PASSWORD 覆盖范围 password
每个人都是。 PRONOTE_ACCOUNT_TYPE 覆盖范围 account_type

多子女抚养

如果您是同一Pronote帐户上有多个孩子的家长 工具接受可选 child_name 参数。将孩子的全名作为 它出现在Pronote中。如果省略,服务器默认为第一个子节点。

使用 get_student_info 列出所有孩子及其班级的工具。

认证

服务器使用标准的Pronote用户名和密码进行身份验证。这是 您在Pronote网站或移动应用程序上使用的相同登录名。

ENT(数字工作空间): 如果你的学校使用耳鼻喉科门户网站 身份验证,您可能需要提供ENT特定的发音URL。检查 pronotepy的文档 耳鼻喉科 配置详细信息。

二维码登录: 尚未得到支持。基于QR码/令牌的身份验证是 计划在未来发布。

会话管理

Pronote会话将在大约30分钟后过期。服务器处理此问题 自动:它将会话缓存25分钟,并透明地重新连接 必要时。无需人工干预。

需求

学分

建于 前天性 通过bain3。

许可证

麻省理工学院 --版权所有2026 HAL-XP