Health Reminder MCP

🚀 健康提醒 MCP 系统

这是一个基于 Model Context Protocol (MCP) 的健康提醒系统，能定时弹出系统通知，提醒您起身活动，有效保护身体健康。

🚀 快速开始

安装依赖

npm install

编译项目

npm run build

运行方式

方式一：运行 Client（推荐）

Client 会自动连接到 Server 并提供交互式控制台：

npm run client

方式二：分别运行 Server 和 Client

终端 1 - 启动 Server:

npm run server

终端 2 - 启动 Client:

npm run client

开发模式

# 启动 Server（开发模式）
npm run dev:server

# 启动 Client（开发模式）
npm run dev:client

✨ 主要特性

• 🔔 定时提醒：每隔指定时间（默认 30 分钟）弹出系统通知。
• ⚙️ 自定义配置：支持自定义提醒间隔、消息内容、通知标题和提示音。
• 📊 状态监控：实时查看提醒运行状态和配置信息。
• 🎯 即时提醒：支持手动触发立即提醒。
• 🖥️ 跨平台：支持 Windows、macOS 和 Linux 系统通知。
• 🔌 MCP 架构：完整的 Client - Server 架构，易于集成和扩展。

📦 安装指南

项目结构

health-reminder-mcp/
├── src/
│   ├── server/
│   │   └── index.ts          # MCP Server 实现
│   └── client/
│       └── index.ts          # MCP Client 实现
├── package.json              # 项目配置
├── tsconfig.json             # TypeScript 配置
└── README.md                 # 说明文档

💻 使用示例

基础用法

示例 1：使用默认配置（30 分钟提醒一次）

1. 运行 npm run client。
2. 选择选项 1。
3. 系统将每 30 分钟弹出一次提醒通知。

高级用法

示例 2：自定义配置（每小时提醒，自定义消息）

1. 运行 npm run client。
2. 选择选项 2。
3. 输入间隔时间：60。
4. 输入标题：休息时间。
5. 输入消息：已经工作一小时了，该休息一下啦！。
6. 选择提示音：y。

示例 3：立即测试通知

1. 运行 npm run client。
2. 选择选项 5。
3. 系统将立即弹出一次通知。

📚 详细文档

使用说明

交互式控制台

启动 Client 后，您将看到以下菜单：

╔════════════════════════════════════╗
║     健康提醒 MCP Client 控制台     ║
╠════════════════════════════════════╣
║  1. 启动健康提醒（默认30分钟）     ║
║  2. 启动健康提醒（自定义配置）     ║
║  3. 停止健康提醒                   ║
║  4. 查看当前状态                   ║
║  5. 立即发送提醒                   ║
║  6. 查看可用工具                   ║
║  0. 退出程序                       ║
╚════════════════════════════════════╝

可用工具（MCP Tools）

MCP Server 提供以下工具：

• start_reminder：启动健康提醒定时器。
  • 参数：
    • interval (number)：提醒间隔时间（分钟），默认 30。
    • message (string)：提醒消息内容。
    • title (string)：通知标题，默认"健康提醒"。
    • sound (boolean)：是否播放提示音，默认 true。
• stop_reminder：停止健康提醒定时器。
• get_status：获取当前健康提醒的状态和配置。
• send_immediate_reminder：立即发送一次健康提醒通知（不影响定时器）。
  • 参数：
    • message (string)：提醒消息内容。
    • title (string)：通知标题。
    • sound (boolean)：是否播放提示音。

自定义默认配置

支持三种方式自定义默认提醒时间和消息：

1. 配置文件（推荐）

编辑项目根目录的 config.json：

{
  "reminder": {
    "interval": 45,
    "message": "已经 45 分钟了，该休息了！",
    "title": "工作提醒",
    "sound": true
  }
}

2. 环境变量

set REMINDER_INTERVAL=60
set REMINDER_MESSAGE=该休息了！
npm run server

3. 调用时传参

在 Cursor 中：启动健康提醒，每 45 分钟一次。

配置优先级：调用参数 > 环境变量 > 配置文件 > 内置默认值。 详细配置说明请查看：配置指南 | 配置示例

系统通知支持

• 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 工具接口文档。
• 使用教程 - 完整的使用教程。

🔧 技术细节

技术栈

• TypeScript：类型安全的 JavaScript 超集。
• Node.js：JavaScript 运行时环境。
• @modelcontextprotocol/sdk：MCP 官方 SDK。
• node-notifier：跨平台系统通知库。

配置说明

默认配置

{
  interval: 30,           // 30分钟
  message: "该起身活动一下了！久坐对健康不利，建议站起来走动走动。",
  title: "健康提醒",
  sound: true            // 开启提示音
}

自定义配置

您可以通过以下方式自定义配置：

1. 通过交互式菜单：选择选项 2，按提示输入配置。
2. 通过 MCP 工具调用：使用 start_reminder 工具并传入参数。

🤝 集成到其他应用

由于使用了 MCP 协议，您可以轻松将此健康提醒系统集成到任何支持 MCP 的应用中：

1. 将 Server 注册到 MCP 配置文件。
2. 使用任何 MCP Client 连接。
3. 调用提供的工具即可。

分享给其他人使用

想让其他人也能使用你的健康提醒系统？查看 发布到 npm 指南

📄 许可证

MIT License

🙏 致谢

• Model Context Protocol
• node-notifier

💪 健康小贴士

• 建议每 30 分钟起身活动 5 - 10 分钟。
• 可以做简单的伸展运动。
• 远眺窗外放松眼睛。
• 适量饮水，保持身体水分。
• 保持良好坐姿，避免长时间低头。

祝您使用愉快，身体健康！ 🌟