AI导哈

校园日历订阅服务

将杭电助手ICS日历订阅接入支持MCP的客户端，查询杭电课程、考试和校园日程。

  • by wzy4163
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 wzy4163/hdu-ics-mcp-server

使用说明

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

  1. 打开 Cherry Studio，进入 设置 → MCP 服务器
  2. 点击 添加服务器，填写以下信息：
    • 名称: 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为你杭电助手订阅链接中的部分
  3. 保存后即可在对话中使用日历相关工具

可用工具

适合回答“今天有什么课”“这周有哪些考试”“搜索某门课或考试”等校园日程问题。

工具 说明 参数
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 说：

  • "今天有什么课？"
  • "这周有哪些课程和考试？"
  • "搜索高等数学相关的课程或考试"

相关 MCP