Skip to main content
Glama

HDU 校园 ICS 课表/考试 MCP

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

快速开始

# 安装依赖
npm install

# 配置 ICS 订阅地址
cp .env.example .env
# 编辑 .env,填入你的 ICS URL
# 可选:调整时区和缓存时间

# 构建
npm run build

Related 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

  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 说:

  • "今天有什么课?"

  • "这周有哪些课程和考试?"

  • "搜索高等数学相关的课程或考试"

Available Tools

3 tools
get_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

    B3.4/5.0

    Scored across 3 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    All three follow a strict verb_noun pattern (get_today_..., get_upcoming_..., search_...). Consistent, predictable, and easy to pattern-match.

    Tool Count4/5

    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.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      -
    • F
      license
      A
      quality
      D
      maintenance
      Enables 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.
      7
      9
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 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
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables Claude to query and manage Mail2000 calendar events, including agenda, search, booking, updating, and deleting events through natural language.
      -