Edupage MCP

教育MCP服务器

MCP服务器，将克劳德连接到Edupage——一个在欧洲各地使用的学校信息系统。提供对时间表、成绩、家庭作业、消息、学生、教师等的访问。

快速设置

1.安装

cd /path/to/edupage-mcp
uv sync

或者，如果你更喜欢没有克隆的单行线：

uv pip install "mcp>=1.2.0" "edupage-api>=0.12.3"

2.配置Claude代码

最简单的方法——只需打开项目文件夹 .mcp.json 将自动拾取。首先设置环境变量：

export EDUPAGE_USERNAME=your_user
export EDUPAGE_PASSWORD=your_pass
export EDUPAGE_SUBDOMAIN=your_school

或者手动添加服务器：

claude mcp add edupage -- uv run --directory /path/to/edupage-mcp python -m edupage_mcp

通过环境变量自动登录：

claude mcp add --env EDUPAGE_USERNAME=your_user --env EDUPAGE_PASSWORD=your_pass --env EDUPAGE_SUBDOMAIN=your_school edupage -- uv run --directory /path/to/edupage-mcp python -m edupage_mcp

3.配置克劳德桌面

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "edupage": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/edupage-mcp", "python", "-m", "edupage_mcp"],
      "env": {
        "EDUPAGE_USERNAME": "your_username",
        "EDUPAGE_PASSWORD": "your_password",
        "EDUPAGE_SUBDOMAIN": "your_school"
      }
    }
  }
}

4.配置协同工作

使用 .mcp.json 这个仓库中包含的文件——只需设置环境变量。

认证

两种选择：

1. 环境变量 （推荐）--设置 EDUPAGE_USERNAME, EDUPAGE_PASSWORD，以及 EDUPAGE_SUBDOMAIN。服务器在启动时自动登录。
2. 手动登录工具 --呼叫 login 或 login_auto 在会话开始时使用工具。

子域是前面的部分 .edupage.org 在学校的URL中（例如。 myschool 为了 https://myschool.edupage.org).

可用工具

项目结构

edupage-mcp/
├── CLAUDE.md              # Developer guide
├── pyproject.toml         # Package config (uv/hatch)
├── .mcp.json              # Claude Code project config
├── .env.example           # Example environment variables
└── src/
    └── edupage_mcp/
        ├── __init__.py
        ├── __main__.py
        └── server.py      # MCP server implementation

发展

直接运行服务器进行测试：

uv run python -m edupage_mcp

MCP检验员测试：

npx @modelcontextprotocol/inspector uv run python -m edupage_mcp

依赖项

• mcp >=1.2.0--模型上下文协议Python SDK
• edupage-api >=0.12.3-非官方Edupage API客户()

备注

• 服务器使用stdio传输（读取stdin，写入stdout）
• 所有日志记录都会进入stderr，以避免损坏MCP协议
• 会话在服务器进程的生命周期内持续存在
• 这 send_message 工具发送真实信息——小心使用
• 如果Edupage请求验证码，请先通过浏览器登录，然后重试

许可证

该项目根据GPL-3.0或更高版本获得许可——请参阅 许可证 文件以获取详细信息。

这 edupage-api 依赖关系是GPL-3.0许可，这要求衍生作品使用兼容的许可。