eClass MCP Server

基本能力

产品定位

eClass MCP Server 是一个用于与 Open eClass 平台实例交互的 MCP 服务器，特别支持 UoA 的 SSO 认证系统。该服务器使 AI 代理能够通过 eClass 进行认证、检索课程信息并在平台上执行基本操作。

核心功能

• 认证：通过 UoA 的 CAS SSO 认证系统登录 eClass
• 课程管理：检索已注册课程列表
• 会话管理：在工具调用之间维护认证会话
• 状态检查：验证认证状态

适用场景

• AI 代理与 eClass 平台的交互
• 课程信息检索
• 认证状态管理

工具列表

• login：使用 SSO 认证登录 eClass
• get_courses：检索已注册课程列表（需要先登录）
• logout：从 eClass 注销
• authstatus：检查当前认证状态

常见问题解答

• 如何配置服务器：在根目录下创建 .env 文件，包含 ECLASS_URL、ECLASS_USERNAME 和 ECLASS_PASSWORD 配置
• 如何运行服务器：使用 python run_server.py 或 python -m src.eclass_mcp_server.server 命令
• 如何测试功能：运行 python -m src.eclass_mcp_server.test.run_all_tests 或特定测试脚本

使用教程

使用依赖

• Python 3.9+

安装教程

# 克隆仓库
git clone https://github.com/yourusername/eClass-MCP-server.git
cd eClass-MCP-server

# 安装依赖
uv sync --dev --all-extras

# 或者使用 pip
pip install -e .

调试方式

# 运行服务器
python run_server.py

# 或者作为模块运行
python -m src.eclass_mcp_server.server

# 运行所有测试
python -m src.eclass_mcp_server.test.run_all_tests

# 运行特定测试
python -m src.eclass_mcp_server.test.test_login
python -m src.eclass_mcp_server.test.test_courses

许可证

该项目遵循 Other 开源许可条款，请参阅 Other 了解完整条款。