内容
# IIT Kharagpur 企业资源计划（ERP）MCP 服务器
IIT Kharagpur ERP 的 MCP 服务器。通过任何 AI 代理查询你的成绩、CGPA、出勤率、课程表、校园招聘信息等。
支持以下 AI 代理：**Claude Code, Claude Desktop, Cursor, Cline, Continue, Zed, 自定义代理** — 任何支持 MCP 协议的代理。
## 安装
```bash
pip install iitkgp-erp-mcp
playwright install chromium
```
## 设置
```bash
iitkgp-erp-setup
```
该命令会安全地将你的凭证存储在操作系统的密钥链中。
## 使用
将以下配置添加到你的 MCP 客户端配置文件（`.mcp.json`、`mcp_servers.json` 等）：
```json
{
"mcpServers": {
"iitkgp-erp": {
"command": "iitkgp-erp-mcp"
}
}
}
```
然后询问你的 AI 代理：
- "我的 CGPA 是多少？"
- "显示我第 4 学期的成绩"
- "比较我在 CS 和 MA 科目中的表现"
- "如果这学期所有科目我都得 A，我的 CGPA 会是多少？"
- "我应该选择哪些选修课？"
- "有新的 SDE 岗位的校园招聘通知吗？"
- "我可以跳过明天的信号课吗？"
- "今天我的日程是什么？"
- "将我的课程表导出到 Google 日历"
- "浏览缴费页面"
## 可用工具（25）
### 成绩与 GPA
| 工具 | 描述 |
|------|-------------|
| `erp_login` | 登录 ERP（处理 OTP） |
| `erp_logout` | 结束会话 |
| `get_grades` | 获取成绩（所有或特定学期） |
| `get_cgpa` | 当前 CGPA |
| `get_sgpa` | 学期 SGPA |
| `get_cgpa_trend` | 学期 CGPA/SGPA 趋势 |
| `compare_subjects` | 比较科目表现 |
| `what_if_cgpa` | CGPA 计算器 |
| `get_grade_distribution` | 成绩分布（EX/A/B/C/D/P/F 计数） |
### 出勤率
| 工具 | 描述 |
|------|-------------|
| `get_attendance` | 所有科目出勤率 |
| `get_attendance_alerts` | 低于 80% 危险区的科目 |
| `can_i_skip` | 你可以安全缺席的课时数 |
### 选修课推荐器
| 工具 | 描述 |
|------|-------------|
| `recommend_electives` | 根据你的成绩模式推荐选修课 |
| `get_strengths_weaknesses` | 你最好的 5 门和最差的 5 门科目 |
| `get_department_performance` | 按部门平均 GPA |
### 课程表与日程
| 工具 | 描述 |
|------|-------------|
| `get_timetable` | 整周或特定日期的日程 |
| `get_today_classes` | 今天的课程 |
| `where_is_prof` | 通过课程表查找教授的位置 |
| `export_timetable_ics` | 导出到 ICS 格式（Google 日历，Apple 日历） |
### 校园招聘与通知
| 工具 | 描述 |
|------|-------------|
| `get_placement_notices` | CDC 通知，按关键词过滤 |
| `get_notice_detail` | 特定通知的全文 |
| `get_academic_notices` | 学术公告 |
### 资源管理器
| 工具 | 描述 |
|------|-------------|
| `browse_erp_page` | 自由浏览任何 ERP 页面 |
| `search_erp_pages` | 按关键词查找 ERP 页面 |
### 实用工具
| 工具 | 描述 |
|------|-------------|
| `clear_cache` | 清除本地缓存数据 |
## 安全性
- 凭证存储在操作系统的密钥链中（绝不会以明文存储）
- 会话仅在本地机器上进行
- OTP 输入实时，不会存储
- 不会将敏感信息提交到 git
## 工作原理
```
你的 AI 代理 ←→ MCP 协议（stdio）←→ iitkgp-erp-mcp 服务器
│
├── iitkgp-erp-login（身份验证）
├── 请求 + BeautifulSoup（网页抓取）
└── Playwright（JS-heavy 页面）
│
▼
erp.iitkgp.ac.in
```
## 成绩评定标准
| 成绩 | 分数 |
|-------|--------|
| EX | 10 |
| A | 9 |
| B | 8 |
| C | 7 |
| D | 6 |
| P | 5 |
| F | 0 |
## 路线图
- [x] 成绩与 GPA 工具
- [x] 出勤率跟踪 + 警报
- [x] 选修课推荐器
- [x] 校园招聘通知集成
- [x] 课程表提取
- [x] 日历同步（ICS 导出）
- [x] 教授查找器
- [x] 学术通知
- [x] 自由 ERP 浏览器
- [ ] 批量成绩分布（历史数据）
- [ ] 注册状态
- [ ] 缴费状态
- [ ] 宿舍信息
## 贡献
欢迎提交 PR！如果 ERP 更改了其 HTML 结构，`src/scrapers/` 中的网页抓取器可能需要更新选择器。
## 许可证
MIT
