个人数据同步工具

MCP-data是一种用于管理待办事项、购物清单、提醒和笔记的个人数据同步工具,支持跨设备双向同步。

  • by JJGantt
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 JJGantt/mcp-data

使用说明

mcp数据

用于个人数据的MCP服务器——列表、提醒和笔记。通过双向rsync在Mac和Pi之间同步。

概述

mcp数据 提供用于管理待办事项列表、杂货清单、提醒和笔记的工具。所有数据都以JSON格式存储在机器之间同步的共享目录中。

非常适合在会话和通道中与Claude保持个人状态同步。

MCP工具

列表

工具 目的
list_items(list_name) 查看列表中的所有活动项目
add_item(list_name, text) 向列表中添加项目
check_item(list_name, id) 将项目标记为已完成
uncheck_item(list_name, id) 将项目标记为未完成
remove_item(list_name, id) 软删除项目(非永久性)
create_list(list_name) 创建新的空列表
review_list(list_name?) 拉一个包含复习说明的列表

提醒事项

工具 目的
list_reminders() 查看所有活动提醒
add_reminder(text, due?) 添加提醒(ISO格式的可选截止日期)
complete_reminder(id) 将提醒标记为已完成
remove_reminder(id) 软删除提醒
review_reminders() 拉取带有审核说明的提醒

备注

工具 目的
get_note(name) 按姓名阅读笔记
set_note(name, content) 撰写或更新笔记
review_notes() 提取所有带有复习说明的笔记

数据格式

列表和提醒使用软删除(项目保留在文件中 deleted: true):

{
  "items": [
    {
      "id": "abc123",
      "text": "Buy milk",
      "done": false,
      "deleted": false,
      "created": "2026-03-01T10:00:00",
      "updated": "2026-03-01T10:05:00"
    }
  ]
}

注释很简单:

{
  "content": "Personal thoughts...",
  "updated": "2026-03-01T10:05:00"
}

存储

  • 列表: ~/pi-data/lists/ (例如。, todo.json, grocery.json)
  • 提醒: ~/pi-data/reminders/reminders.json
  • 笔记: ~/pi-data/notes/ (例如。, general.json)

同步

Mac(~/pi-data/) ↔ Pi(/home/jaredgantt/data/)每30分钟通过同步 sync_mac_to_pi.sh 和 sync_pi_data.sh.

合并逻辑 merge.py 处理冲突的编辑(保持最新)。

相关

  • 历史: mcp历史 --对话历史和背景