机灵助手 - 桌面提醒应用

一个基于 Electron 的桌面提醒应用，支持基于 Cursor 等 AI IDE，通过 MCP (Model Context Protocol) 协议接收提醒指令，提供单次提醒和每天重复提醒功能。

✨ 功能特性

• 🕐 单次提醒：支持设置指定时间的单次提醒任务
• 🔄 每天重复提醒：支持设置每天固定时间的重复提醒
• 💾 任务持久化：任务数据自动保存到本地文件，应用重启后自动恢复
• 🎨 现代化 UI：基于 React + Tailwind CSS 构建的简洁美观界面
• 🔔 系统通知：使用系统原生通知，支持 macOS、Windows、Linux
• 📱 系统托盘：最小化到系统托盘，双击图标快速打开窗口
• 🗑️ 任务管理：支持查看、删除待触发的提醒任务
• 🔌 MCP 集成：通过 MCP Server 接收 AI 助手的提醒指令

📦 项目结构

cursor-mcp-desktop-reminder/
├── electron-reminder/          # Electron 主应用
│   ├── src/                    # React 前端代码
│   │   ├── App.tsx            # 主应用组件
│   │   ├── main.tsx           # React 入口
│   │   └── index.css          # 样式文件
│   ├── main.ts                # Electron 主进程
│   ├── main-entry.cjs         # 入口文件
│   └── package.json
├── mcp-server-reminder/        # MCP Server
│   ├── index.ts               # MCP Server 实现
│   └── package.json
└── README.md

🚀 快速开始

前置要求

• Node.js >= 18
• pnpm >= 8

安装依赖

方式 1：一键安装（推荐）

在项目根目录下运行：

cd cursor-mcp-desktop-reminder
pnpm install:all

方式 2：分别安装

# 安装 Electron 应用依赖
cd electron-reminder
pnpm install

# 安装 MCP Server 依赖
cd ../mcp-server-reminder
pnpm install

开发模式

方式 1：一键启动（推荐）

在项目根目录下运行：

# 首次使用需要安装依赖
cd cursor-mcp-desktop-reminder
pnpm install

# 一键启动所有服务
pnpm dev

这将同时启动：

• MCP Server 监听模式（TypeScript 自动编译）
• Vite 开发服务器（前端）
• Electron 应用
• Express API 服务器（端口 4000）

方式 2：分别启动

# 终端1：启动 MCP Server 监听
cd mcp-server-reminder
pnpm watch

# 终端2：启动 Electron 应用
cd electron-reminder
pnpm start:dev

构建生产版本

# 构建前端
pnpm build

# 运行生产版本
pnpm start

构建 MCP Server

cd mcp-server-reminder
pnpm build

🔧 配置 MCP Server

在 Cursor 或其他支持 MCP 的 AI 助手中配置：

{
  "mcpServers": {
    "ghost-reminder": {
      "command": "node",
      "args": ["/path/to/mcp-server-reminder/dist/index.js"]
    }
  }
}

📡 API 接口

创建单次提醒

POST http://localhost:4000/notify
Content-Type: application/json

{
  "title": "提醒标题",
  "content": "提醒内容",
  "time": "2024-01-01T12:00:00.000Z"
}

创建每天重复提醒

POST http://localhost:4000/notify-daily
Content-Type: application/json

{
  "title": "提醒标题",
  "content": "提醒内容",
  "time": "14:30"
}

获取所有任务

GET http://localhost:4000/tasks

删除任务

DELETE http://localhost:4000/tasks/:id

🎯 使用示例

通过 MCP 设置提醒

在支持 MCP 的 AI IDE Chat 中，可以直接使用自然语言：

• "十分钟后提醒我点奶茶"
• "每天十一点提醒我点外卖"
• "明天下午三点提醒我开会"

通过 API 设置提醒

# 单次提醒
curl -X POST http://localhost:4000/notify \
  -H "Content-Type: application/json" \
  -d '{
    "title": "会议提醒",
    "content": "下午3点有重要会议",
    "time": "2024-01-01T15:00:00.000Z"
  }'

# 每天重复提醒
curl -X POST http://localhost:4000/notify-daily \
  -H "Content-Type: application/json" \
  -d '{
    "title": "喝水提醒",
    "content": "记得多喝水",
    "time": "10:00"
  }'

🛠️ 技术栈

Electron 应用

• Electron - 跨平台桌面应用框架
• React - UI 框架
• TypeScript - 类型安全
• Vite - 构建工具
• Tailwind CSS - 样式框架
• Express - API 服务器
• node-schedule - 任务调度
• dayjs - 日期处理

MCP Server

• @modelcontextprotocol/sdk - MCP SDK
• TypeScript - 类型安全
• Zod - 数据验证

📝 数据存储

任务数据存储在应用的用户数据目录：

• macOS: ~/Library/Application Support/electron-reminder/tasks.json
• Windows: %APPDATA%/electron-reminder/tasks.json
• Linux: ~/.config/electron-reminder/tasks.json

🎨 界面预览

应用提供简洁的任务管理界面：

• 显示所有待触发和已触发的任务
• 实时显示任务状态和剩余时间
• 支持删除待触发的任务
• 自动刷新任务列表