Health Reminder 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., "@Health Reminder MCP Serverstart a reminder every 45 minutes with message 'Time to stretch!'"
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.
健康提醒 MCP 系统
一个基于 Model Context Protocol (MCP) 的健康提醒系统,可以定时弹出系统通知提醒您起身活动,保护健康。
✨ 功能特性
🔔 定时提醒: 每隔指定时间(默认30分钟)弹出系统通知
⚙️ 自定义配置: 支持自定义提醒间隔、消息内容、通知标题和提示音
📊 状态监控: 实时查看提醒运行状态和配置信息
🎯 即时提醒: 支持手动触发立即提醒
🖥️ 跨平台: 支持 Windows、macOS 和 Linux 系统通知
🔌 MCP 架构: 完整的 Client-Server 架构,易于集成和扩展
Related MCP server: Suzu (鈴) - Claude Code Notification Server
📦 项目结构
health-reminder-mcp/
├── src/
│ ├── server/
│ │ └── index.ts # MCP Server 实现
│ └── client/
│ └── index.ts # MCP Client 实现
├── package.json # 项目配置
├── tsconfig.json # TypeScript 配置
└── README.md # 说明文档🚀 快速开始
1. 安装依赖
npm install2. 编译项目
npm run build3. 运行方式
方式一:运行 Client(推荐)
Client 会自动连接到 Server 并提供交互式控制台:
npm run client方式二:分别运行 Server 和 Client
终端 1 - 启动 Server:
npm run server终端 2 - 启动 Client:
npm run client4. 开发模式
# 启动 Server(开发模式)
npm run dev:server
# 启动 Client(开发模式)
npm run dev:client💡 使用说明
交互式控制台
启动 Client 后,您将看到以下菜单:
╔════════════════════════════════════╗
║ 健康提醒 MCP Client 控制台 ║
╠════════════════════════════════════╣
║ 1. 启动健康提醒(默认30分钟) ║
║ 2. 启动健康提醒(自定义配置) ║
║ 3. 停止健康提醒 ║
║ 4. 查看当前状态 ║
║ 5. 立即发送提醒 ║
║ 6. 查看可用工具 ║
║ 0. 退出程序 ║
╚════════════════════════════════════╝可用工具(MCP Tools)
MCP Server 提供以下工具:
1. start_reminder
启动健康提醒定时器
参数:
interval(number): 提醒间隔时间(分钟),默认 30message(string): 提醒消息内容title(string): 通知标题,默认"健康提醒"sound(boolean): 是否播放提示音,默认 true
2. stop_reminder
停止健康提醒定时器
3. get_status
获取当前健康提醒的状态和配置
4. send_immediate_reminder
立即发送一次健康提醒通知(不影响定时器)
参数:
message(string): 提醒消息内容title(string): 通知标题sound(boolean): 是否播放提示音
📝 使用示例
示例 1:使用默认配置(30分钟提醒一次)
运行
npm run client选择选项
1系统将每 30 分钟弹出一次提醒通知
示例 2:自定义配置(每小时提醒,自定义消息)
运行
npm run client选择选项
2输入间隔时间:
60输入标题:
休息时间输入消息:
已经工作一小时了,该休息一下啦!选择提示音:
y
示例 3:立即测试通知
运行
npm run client选择选项
5系统将立即弹出一次通知
⚙️ 自定义默认配置
支持三种方式自定义默认提醒时间和消息:
1. 配置文件(推荐)
编辑项目根目录的 config.json:
{
"reminder": {
"interval": 45,
"message": "已经 45 分钟了,该休息了!",
"title": "工作提醒",
"sound": true
}
}2. 环境变量
set REMINDER_INTERVAL=60
set REMINDER_MESSAGE=该休息了!
npm run server3. 调用时传参
在 Cursor 中:启动健康提醒,每 45 分钟一次
配置优先级:调用参数 > 环境变量 > 配置文件 > 内置默认值
🛠️ 技术栈
TypeScript: 类型安全的 JavaScript 超集
Node.js: JavaScript 运行时环境
@modelcontextprotocol/sdk: MCP 官方 SDK
node-notifier: 跨平台系统通知库
🔧 配置说明
默认配置
{
interval: 30, // 30分钟
message: "该起身活动一下了!久坐对健康不利,建议站起来走动走动。",
title: "健康提醒",
sound: true // 开启提示音
}自定义配置
您可以通过以下方式自定义配置:
通过交互式菜单:选择选项 2,按提示输入配置
通过 MCP 工具调用:使用
start_reminder工具并传入参数
📱 系统通知支持
Windows 10/11: 使用原生通知中心
macOS: 使用原生通知中心
Linux: 使用 libnotify (需要安装)
Linux 安装通知支持
# Ubuntu/Debian
sudo apt-get install libnotify-bin
# Fedora
sudo dnf install libnotify
# Arch Linux
sudo pacman -S libnotify📚 文档
部署方式
部署方式指南 - 了解不同部署方式的区别
发布到 npm - 📦 推荐!像
chrome-devtools-mcp一样分享你的 MCP Server服务器部署 - 云服务器部署(仅供参考,不推荐用于本项目)
使用和配置
Cursor 配置指南 - 在 Cursor 中使用 MCP
配置说明 - 详细的配置选项
API 文档 - MCP 工具接口文档
使用教程 - 完整的使用教程
🤝 集成到其他应用
由于使用了 MCP 协议,您可以轻松将此健康提醒系统集成到任何支持 MCP 的应用中:
将 Server 注册到 MCP 配置文件
使用任何 MCP Client 连接
调用提供的工具即可
分享给其他人使用
想让其他人也能使用你的健康提醒系统?查看 发布到 npm 指南
📄 许可证
MIT License
🙏 致谢
💪 健康小贴士
建议每 30 分钟起身活动 5-10 分钟
可以做简单的伸展运动
远眺窗外放松眼睛
适量饮水,保持身体水分
保持良好坐姿,避免长时间低头
祝您使用愉快,身体健康! 🌟
Available Tools
4 toolsget_statusB
获取当前健康提醒的状态和配置
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. The description only states what the tool does ('get current health reminder status and configuration') without revealing any behavioral traits such as whether it's read-only (implied but not stated), what permissions might be required, whether it returns real-time or cached data, error conditions, or response format. For a tool with zero annotation coverage, this is a significant gap in behavioral context.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence in Chinese that directly states the tool's purpose with zero wasted words. It's appropriately sized for a simple, parameterless tool and is front-loaded with the core functionality. Every word earns its place by conveying essential information about what the tool retrieves.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity (0 parameters, no annotations, no output schema), the description is minimally adequate. It tells the agent what the tool does but lacks details on behavioral aspects (e.g., read-only nature, response format) that would be helpful. For a status retrieval tool with no structured metadata, the description should ideally provide more context about what 'status and configuration' includes or how the data is returned, but it meets the bare minimum for such a simple tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has 0 parameters, and schema description coverage is 100% (though trivial since there are no parameters). The description doesn't need to compensate for any parameter documentation gaps. It appropriately doesn't mention parameters, as none exist. The baseline for 0 parameters is 4, as there's no parameter information to add beyond what the schema provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: '获取当前健康提醒的状态和配置' translates to 'Get current health reminder status and configuration'. This specifies the verb ('get') and resource ('health reminder status and configuration'), making it clear what the tool does. However, it doesn't explicitly differentiate from sibling tools like 'send_immediate_reminder' or 'start_reminder', which appear to be action-oriented tools rather than status retrieval tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. While the purpose implies it's for retrieving status/configuration (unlike siblings that perform actions like sending or starting reminders), there's no explicit mention of when this tool is appropriate, what prerequisites might exist, or when to choose other tools. The agent must infer usage from the tool name and description alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
send_immediate_reminderB
立即发送一次健康提醒通知(不影响定时器)
| Name | Required | Description | Default |
|---|---|---|---|
| message | No | 提醒消息内容 | 该起身活动一下了! |
| title | No | 通知标题 | 健康提醒 |
| sound | No | 是否播放提示音 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden. It mentions the notification doesn't affect timers, which is useful behavioral context. However, it lacks critical details: whether this requires specific permissions, what happens if the system isn't running, whether notifications are guaranteed to deliver, or any rate limits. For a notification-sending tool with zero annotation coverage, this is insufficient.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient Chinese sentence that conveys the core purpose and key behavioral constraint ('不影响定时器'). Every word earns its place with zero waste, making it appropriately sized and front-loaded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given a notification-sending tool with 3 parameters, no annotations, and no output schema, the description provides basic purpose and one behavioral constraint. However, it lacks information about success/failure responses, error conditions, or system state requirements. It's minimally adequate but has clear gaps for a tool that performs an action with side effects.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all three parameters (message, title, sound) with descriptions and defaults. The description adds no parameter-specific information beyond what's in the schema. Baseline 3 is appropriate when schema does the heavy lifting.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('立即发送' - immediately send) and resource ('健康提醒通知' - health reminder notification), specifying it's a one-time notification that doesn't affect timers. It distinguishes from siblings like start_reminder/stop_reminder by emphasizing the immediate, non-recurring nature. However, it doesn't explicitly contrast with get_status.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage context by stating '不影响定时器' (doesn't affect timers), suggesting this is for one-off reminders separate from scheduled ones. However, it doesn't provide explicit guidance on when to use this versus alternatives like start_reminder for recurring reminders or get_status for checking state.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
start_reminderA
启动健康提醒定时器,每隔指定时间弹出系统通知
| Name | Required | Description | Default |
|---|---|---|---|
| interval | No | 提醒间隔时间(分钟),默认 30 分钟 | |
| message | No | 提醒消息内容 | 该起身活动一下了!久坐对健康不利,建议站起来走动走动。 |
| title | No | 通知标题 | 健康提醒 |
| sound | No | 是否播放提示音 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden but only states basic behavior (starts timer, pops system notifications). It doesn't disclose important traits like whether this requires system permissions, if it runs in background, error handling, or how it interacts with existing reminders. For a tool with potential system-level impact, this is insufficient.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient Chinese sentence that directly states the tool's core functionality with zero wasted words. It's appropriately sized and front-loaded with the essential action.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a timer-starting tool with 4 parameters and no output schema, the description covers the basic purpose but lacks important context about system requirements, persistence, and error behavior. Without annotations, it should provide more operational details for a tool that interacts with system notifications.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all 4 parameters thoroughly. The description doesn't add any parameter-specific information beyond what's in the schema, maintaining the baseline score.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose with specific verb ('启动' - start) and resource ('健康提醒定时器' - health reminder timer), and distinguishes it from siblings by specifying it creates a recurring timer (vs. send_immediate_reminder for one-time or stop_reminder for stopping).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies when to use this tool (to start recurring reminders with system notifications) but doesn't explicitly contrast with alternatives like send_immediate_reminder or mention prerequisites. However, the context is clear enough for basic differentiation.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
stop_reminderB
停止健康提醒定时器
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden for behavioral disclosure. It states the action ('stop') but doesn't describe what happens when invoked (e.g., whether it's idempotent, if it returns confirmation, if it affects scheduled reminders, or if it requires specific permissions). This leaves significant gaps for a mutation tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence in Chinese that directly states the tool's purpose without any wasted words. It's appropriately sized and front-loaded, making it easy to parse quickly.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (a mutation with no parameters) and lack of annotations/output schema, the description is minimally adequate but incomplete. It states what the tool does but omits behavioral details (e.g., effects, return values, error conditions) that would help an agent use it correctly in context with siblings.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has 0 parameters with 100% schema description coverage, so the schema fully documents the lack of inputs. The description doesn't need to add parameter semantics, and it doesn't incorrectly imply parameters exist. A baseline of 4 is appropriate for zero-parameter tools.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('停止' meaning 'stop') and the target resource ('健康提醒定时器' meaning 'health reminder timer'), providing a specific verb+resource combination. However, it doesn't explicitly differentiate from sibling tools like 'start_reminder' or 'send_immediate_reminder' beyond the obvious semantic difference.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives like 'start_reminder' or 'send_immediate_reminder', nor does it mention prerequisites (e.g., whether a reminder must be running first) or exclusions. Usage is implied from the name but not explicitly stated.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
4 tool updates
- First observed
get_status - First observed
send_immediate_reminder - First observed
start_reminder - First observed
stop_reminder
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose with no overlap: get_status retrieves configuration, send_immediate_reminder triggers a one-time notification, start_reminder initiates a recurring timer, and stop_reminder terminates it. The actions (get, send, start, stop) target different aspects of the reminder system, making misselection unlikely.
All tools follow a consistent verb_noun pattern (e.g., get_status, send_immediate_reminder, start_reminder, stop_reminder) using snake_case throughout. The verbs are clear and descriptive, with no deviations in style or convention across the set.
With 4 tools, the server is well-scoped for managing health reminders, covering essential operations: checking status, sending notifications, and controlling the timer. Each tool earns its place without redundancy, fitting a typical small utility server range (3-15 tools).
The toolset provides complete lifecycle coverage for a basic reminder system: start, stop, status check, and manual triggering. A minor gap is the lack of configuration update tools (e.g., modify reminder interval or message), but agents can work around this by restarting with new settings.
Maintenance
Related MCP Connectors
Let your AI agent notify you by email, Slack, Discord, or webhook. One tool: send_notification.
Dead-man switch monitors for cron & AI agents with dependency-cascade alerts. No account needed.
Push notifications for AI agents - send instant iPhone notifications from any MCP client.
- mcp-serverOAuthnet.vybit
Push notifications with personalized sounds - manage and trigger your vybits via MCP
Related MCP Servers
- FlicenseCqualityDmaintenanceSends system notifications when AI completes responses in MCP-compatible code editors, with cross-platform support for macOS, Windows, and Linux including customizable titles, messages, icons, and sound effects.2-
- AlicenseBqualityDmaintenancePlays Spotify tracks or system sounds as notifications when Claude Code completes tasks, with desktop notifications and cross-platform support for macOS, Linux, and Windows.86 npm1MIT
- AlicenseBqualityDmaintenanceEnables AI development tools on Windows to send native system notifications for task completion, errors, and reminders, with customizable icons and sounds.75 npm7MIT
- FlicenseAqualityDmaintenanceEnables AI agents to send cross-platform desktop notifications with priority levels, categories, and configurable duration.1-