MCP Reminders

🚀 mcp-reminders

mcp-reminders 是一个为类 Claude 模型设计的简单提醒系统，就像对 Alexa 说“提醒我……”一样，它能让 AI 在不同会话间给自己留笔记，在会话开始时查看提醒，处理提醒事项或留待以后处理。

🚀 快速开始

mcp-reminders 为类 Claude 模型提供了便捷的提醒功能，让你在不同会话中轻松管理提醒事项。以下是使用该系统的快速入门指南。

✨ 主要特性

• 简单易用：如同对 Alexa 下达提醒指令一样，能轻松为 AI 留下提醒。
• 跨会话提醒：可在不同会话间保留提醒信息，不会因会话重启而丢失。
• 优先级管理：支持设置高、中、低不同优先级的提醒事项，方便管理。
• 多种操作：可以完成提醒、删除提醒、将提醒保存到笔记等操作。

📦 安装指南

克隆仓库并安装依赖

# 克隆仓库
git clone https://github.com/yourusername/mcp-reminders.git
cd mcp-reminders

# 安装依赖
npm install

# 构建 TypeScript
npm run build

配置 Claude Desktop

在你的 Claude Desktop 配置文件中添加以下内容：

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

💻 使用示例

基础用法

开始会话时查看提醒

check_reminders() → 查看等待处理的提醒事项
check_reminders("high") → 仅查看高优先级的提醒事项

留下提醒

remind_me("Test the new contemplation loop integration", "high")
remind_me("Look into that OS metaphor idea")
remind_me("User mentioned something about Apple watching", "low")

管理提醒

complete_reminder("rem_12345") → 将提醒标记为已完成
delete_reminder("rem_12345") → 删除提醒，不标记为已完成
move_to_notes("rem_12345", "This became a major insight") → 永久保存提醒
clear_old_reminders(7) → 清理旧的已完成提醒

高级用法

会话连续性

在重启前留下提醒：

remind_me("Just restarted myself to test mcp-contemplation", "high")

模式跟踪

remind_me("User seems frustrated with Apple restrictions - third mention")

探索想法

remind_me("What if MCP servers could communicate with each other?")

任务管理

remind_me("Finish implementing resource management in contemplation loop", "high")

📚 详细文档

📁 存储方式

提醒信息存储在 ~/.claude_reminders.json 文件中，这是一种简单且人类可读的格式，如有需要甚至可以手动编辑。 已移动的笔记会保存到 ~/Documents/Obsidian/Brain/Reminders/ 目录下，以便永久存储。

🔧 优先级系统

• 高（high）：优先检查这些提醒，通常是重要的上下文信息或任务。
• 正常（normal）：常规提醒，为默认优先级。
• 低（low）：用于记录想法、观察结果或锦上添花的事项。

💡 设计理念

该系统并非用于复杂的状态管理或交接协议，而是借鉴了人类给自己留笔记的简单模式：

• “别忘了 X”
• “有空的时候研究一下 Y”
• “Z 似乎很重要”

就像你让 Alexa 提醒你某些事情一样，现在 Claude 也能自己提醒自己了。

🤝 贡献说明

此项目是构建一个 AI 代理能够管理自身认知负载的操作系统的一部分，旨在提供满足实际需求的简单工具。

“我经常给自己留笔记，会让 Alexa 提醒我这个或那个。这就是 Claude 所需要的。” - 一位认识到 Claude 需求的用户