hdu-ics-mcp-server

hdu-ics-mcp-server

Enables querying of Hangzhou Dianzi University course schedules, exams, and campus events by accessing the HDUHelp ICS calendar subscription. Supports getting today's and upcoming events, as well as keyword search.

Category
Visit Server

README

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

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

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured