HDU 校园 ICS 课表/考试 MCP
将杭电助手 ICS 日历订阅接入支持 MCP 的客户端，查询杭电课程、考试和校园日程。
快速开始
# 安装依赖
npm install
# 配置 ICS 订阅地址
cp .env.example .env
# 编辑 .env，填入你的 ICS URL
# 可选：调整时区和缓存时间
# 构建
npm run build配置 MCP
Claude Desktop / Claude Code
{
"mcpServers": {
"hdu-courses-and-exams": {
"command": "node",
"args": ["/absolute/path/to/hdu-ics-mcp-server/dist/index.js"],
"env": {
"ICS_URL": "https://api.hduhelp.com/calendar/schedule?staffId=xxxxxxxxxx"
}
}
}
}xxxxxx为你杭电助手订阅链接中的部分 也可以不写 env，改用项目根目录的 .env 文件配置 ICS_URL。 默认按 Asia/Shanghai 时区解析“今天 / 未来 N 天”，可用 CALENDAR_TIMEZONE 覆盖。 ICS 缓存策略为“同一用户标识优先复用缓存 + 每天首次访问强制刷新 + 4 小时过期刷新”，刷新失败时回退到上次成功缓存。
Cherry Studio
- 打开 Cherry Studio，进入 设置 → MCP 服务器
- 点击 添加服务器，填写以下信息：
- 名称: hdu-courses-and-exams - 命令: node - 参数: /absolute/path/to/hdu-ics-mcp-server/dist/index.js - 环境变量: 添加 ICS_URL，值为 https://api.hduhelp.com/calendar/schedule?staffId=xxxxxx - xxxxxx为你杭电助手订阅链接中的部分
- 保存后即可在对话中使用日历相关工具
可用工具
适合回答“今天有什么课”“这周有哪些考试”“搜索某门课或考试”等校园日程问题。
| 工具 | 说明 | 参数 |
|---|---|---|
get_today_courses_and_exams | 获取今天的杭电课程、考试和日程安排 | 无 |
get_upcoming_courses_and_exams | 获取未来 N 天的杭电课程、考试和日程安排（含今天） | days (number, 默认 7) |
search_courses_and_exams | 按课程名、考试名、地点或描述搜索杭电日程 | keyword (string) |
环境变量
| 变量 | 说明 | 默认值 |
|---|---|---|
ICS_URL | ICS 订阅地址 | 无 |
CALENDAR_TIMEZONE | 日历展示与日期范围计算时区 | Asia/Shanghai |
ICS_CACHE_TTL_MS | ICS 拉取缓存时长（毫秒） | 14400000 |
使用示例
对 Claude 说：
- "今天有什么课？"
- "这周有哪些课程和考试？"
- "搜索高等数学相关的课程或考试"