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 需求的用戶