hdu-ics-mcp-server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@hdu-ics-mcp-server What are my courses and exams today?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
HDU 校园 ICS 课表/考试 MCP
将杭电助手 ICS 日历订阅接入支持 MCP 的客户端,查询杭电课程、考试和校园日程。
快速开始
# 安装依赖
npm install
# 配置 ICS 订阅地址
cp .env.example .env
# 编辑 .env,填入你的 ICS URL
# 可选:调整时区和缓存时间
# 构建
npm run buildRelated MCP server: zju-mcp
配置 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=xxxxxxxxxxxx为你杭电助手订阅链接中的部分
保存后即可在对话中使用日历相关工具
可用工具
适合回答“今天有什么课”“这周有哪些考试”“搜索某门课或考试”等校园日程问题。
工具 | 说明 | 参数 |
| 获取今天的杭电课程、考试和日程安排 | 无 |
| 获取未来 N 天的杭电课程、考试和日程安排(含今天) |
|
| 按课程名、考试名、地点或描述搜索杭电日程 |
|
环境变量
变量 | 说明 | 默认值 |
| ICS 订阅地址 | 无 |
| 日历展示与日期范围计算时区 |
|
| ICS 拉取缓存时长(毫秒) |
|
使用示例
对 Claude 说:
"今天有什么课?"
"这周有哪些课程和考试?"
"搜索高等数学相关的课程或考试"
Available Tools
3 toolsget_today_courses_and_examsB
获取今天的杭电课程、考试和日程安排
Inputs: no named parameters.
get_upcoming_courses_and_examsB
获取未来 N 天的杭电课程、考试和日程安排
Inputs: days.
search_courses_and_examsB
按关键词搜索杭电课程、考试和日程(搜索名称、地点、描述)
Inputs: keyword (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
The three tools split cleanly along time/query axes: today, next N days, and keyword search. The only mild overlap is that 'today' is a special case of 'upcoming' (N=1), which an agent could conflate, but the descriptions make the intent clear.
All three follow a strict verb_noun pattern (get_today_..., get_upcoming_..., search_...). Consistent, predictable, and easy to pattern-match.
Three tools is lean but well-matched to a read-only schedule/exam lookup domain. It is on the thin side (no detail or date-specific query), but each tool earns its place.
Core read workflows (today, upcoming, search) are covered, but there is no way to query an arbitrary date or date range, nor to fetch a single course/exam's full detail. These are workable gaps for an agent but limit the surface.
Maintenance
Related MCP Connectors
Read and change Google Calendar and Outlook events, find free time and add meeting links.
Extracts calendar events from natural-language text, with .ics and calendar links.
Calendar, free time, and event scheduling
Calendar API for AI agents: events, availability, Google/Microsoft setup, scheduling, and iCal.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables querying University of Caen (Unicaen) schedule data to find next classes for professors, students, or rooms and check room availability. Integrates with ADE scheduling system to provide real-time schedule information through natural language queries.-
- FlicenseAqualityDmaintenanceEnables interaction with Zhejiang University's learning platform (学在浙大 / 智云课堂) via MCP tools, allowing natural language commands to check todos, view schedules, fetch lecture transcripts, and submit homework.79-
- AlicenseNot gradedqualityDmaintenanceProvides read-only access to calendar events from iCal feeds, enabling agents to query schedules, search events, and check availability via natural language.AGPL 3.0
- FlicenseNot gradedqualityBmaintenanceEnables Claude to query and manage Mail2000 calendar events, including agenda, search, booking, updating, and deleting events through natural language.-