MemPlato

🏛️ MemPlato

运行在 Android 手机上的个人 MCP 记忆服务。

每次 AI 对话都从零开始。MemPlato 解决了这个问题——它是 AI 助手的持久化记忆层，完全运行在你自己的设备上。你的数据永远不会离开手机。

---

什么是 MemPlato？

MemPlato 可将你的 Android 手机变成私有 MCP（模型上下文协议）服务。Claude、Perplexity、Cursor 等 AI 工具可以连接到它，并在不同对话间记住信息——你的项目、偏好、笔记和上下文——而无需将任何数据发送到云服务。

手机留在你的口袋里。记忆留在你的设备上。

Your Phone (Termux)          Relay Server              AI Assistant
─────────────────            ─────────────             ──────────────
memplato_server.py  ←──SSH──  relay.memplato.com  ←──MCP──  Claude
port 7333                     (just a bridge)
SQLite + ONNX                 your data never stored

---

截图

---

安装视频

👆 点击观看 YouTube 上的完整安装教程

---

工作原理

MemPlato 会在 Android 手机上的 Termux 内运行 Python FastAPI 服务。通过 relay.memplato.com 建立的反向 SSH 隧道，为 AI 客户端提供稳定的 HTTPS 端点以供连接。中继只是一个简单的管道——它绝不会存储你的数据。

技术栈： Flutter（Android 应用）· Python 3.13 · FastAPI · SQLite · ONNX Runtime · MCP SSE · autossh

---

功能

• 29 个 MCP 工具——抽屉、知识图谱、日记、隧道、语义搜索
• 语义搜索，使用本地 ONNX 嵌入（all-MiniLM-L6-v2，可离线运行）
• 知识图谱，支持时间性事实（valid_from / valid_to）
• 跨分区隧道——连接相关的记忆簇
• Agent 日记——每个 Agent 独立的日志条目
• 你的数据留在手机上——100% 的记忆都存储在你的本地设备上，绝不保存在外部服务上
• 自动重连监控程序——隧道断开时自动重启
• 英文 + 乌克兰语界面

---

支持的 AI 客户端

客户端	连接类型	状态
Claude (claude.ai)	MCP SSE	✅ 已测试
Claude Desktop	MCP SSE	✅ 已测试
Perplexity	MCP SSE	✅ 已测试
Cursor	MCP SSE	✅ 已测试
任何兼容 MCP 的客户端	SSE 或 HTTP	应该可用

---

下载

👉 下载最新版 APK（v1.0.7）

APK 大约为 280 MB，因为它包含 Python、所有库和 AI 模型，因此在手机上设置时无需互联网连接。

---

设置指南

所需条件

• Android 手机（建议使用 Android 12+，ARM64）
• 约 1 GB 可用存储空间
• 耐心 ☕

快速概览

1. 安装 Termux from GitHub（不要从 Play Store 安装——版本已过时）
2. 安装 MemPlato APK
3. 在 Android 设置中授予权限
4. 按照应用内的设置步骤操作——应用会全程引导你
5. 点击 Install and Start——设置需要 30–90 分钟，请保持屏幕亮起并连接充电器
6. 完成后会出现一个绿点，并显示你的专属 URL：

https://relay.memplato.com/u/YOUR_ID/mcp

7. 在 Claude → Settings → Connectors → Add MCP server 中粘贴你的 URL

持续使用

Termux 必须在后台保持运行（你会在通知栏中看到它）。看门狗脚本会在隧道断开时自动重新启动。你无需进行任何操作——只需保持 Termux 打开即可。

⚠️ 已知限制： 手机重启后，服务不会自动重新启动。请使用应用中的 Start 按钮手动重启。未来更新将加入开机自动启动功能。

---

MCP 工具参考

📦 抽屉（记忆存储）

工具	描述
memplato_add_drawer	将记忆保存到一个翅膀／房间中
memplato_get_drawer	按 ID 获取抽屉
memplato_update_drawer	更新内容或移至新的翅膀／房间
memplato_delete_drawer	删除抽屉
memplato_list_drawers	列出抽屉，可选择使用筛选条件
memplato_search	语义 + 关键词搜索
memplato_check_duplicate	检查是否已存在相似内容
memplato_get_taxonomy	完整的翅膀 → 房间 → 数量概览

🧠 知识图谱

工具	描述
memplato_kg_add	添加事实：主语 → 谓语 → 宾语
memplato_kg_query	查询某个实体的关系
memplato_kg_invalidate	将某个事实标记为已过期
memplato_kg_timeline	事实的时间顺序时间线
memplato_kg_stats	图谱统计信息

🔗 隧道与图谱

工具	描述
memplato_create_tunnel	链接两个记忆位置
memplato_list_tunnels	列出所有隧道
memplato_follow_tunnels	查看某个房间连接到哪些位置
memplato_traverse	从某个房间遍历记忆图谱
memplato_find_tunnels	查找连接两个翅膀的房间
memplato_delete_tunnel	移除隧道
memplato_graph_stats	图谱概览

📔 日记与系统

工具	描述
memplato_diary_write	写入每个 Agent 的日记
memplato_diary_read	读取最近的日记条目
memplato_status	服务状态概览
memplato_hook_settings	配置行为标志
memplato_reconnect	强制重新连接数据库
memplato_memories_filed_away	检查上次检查点
memplato_get_aaak_spec	AAAK 压缩记忆格式规范

---

测试

MemPlato v1.0.5 已通过 140 多个测试用例的测试，覆盖全部 29 个工具，包括边界情况、压力测试和故障场景。

结果摘要：

类别	测试数	通过
抽屉（CRUD）	20	✅ 18/20
语义搜索	9	✅ 7/9
知识图谱	13	✅ 12/13
隧道与图谱	15	✅ 13/15
日记与系统	11	✅ 11/11
边界情况与压力测试	72+	✅ 大多数通过

已知问题：

服务运行稳定，处理所有边界情况时都不会崩溃。以下已知限制将在下一个主要版本中解决：

• 嵌入质量 — 为移动设备优化的轻量级 ONNX 模型（all-MiniLM-L6-v2）偶尔会为不相关的文本给出意料之外的相似度分数。常见场景下搜索运行可靠。v2 将使用更好的模型进行改进。
• 跨语言搜索 — 乌克兰语和英语混合查询有时会导致排名不理想。为获得最佳效果，请使用与已存储内容相同的语言。
• 重复内容保护 — add_drawer 不会自动调用 check_duplicate。最佳做法是在保存之前手动调用 check_duplicate。
• 搜索结果数量限制 — 语义搜索针对最多返回 10 条结果的查询进行了优化。在某些配置下，请求更多结果可能会导致错误。
• 重启后自动启动 — 重启后自动启动 — 手机重启后，请使用应用中的 Start 按钮手动重启服务。未来更新将加入开机自动启动功能。

所有已知问题都只是表面问题或边界情况。核心功能——存储记忆、知识图谱和 MCP 连接——均可可靠运行。

---

架构

Android Phone
├── MemPlato.apk (Flutter)
│   ├── Manages setup flow
│   ├── Copies all files to Termux
│   └── Shows server status
│
└── Termux (Linux environment)
    ├── memplato_server.py (FastAPI + MCP)
    │   ├── /sse  ← MCP SSE endpoint
    │   ├── /mcp  ← MCP HTTP endpoint
    │   └── /health
    ├── palace.db (SQLite)
    ├── models/onnx/ (384-dim embeddings)
    ├── autossh (reverse tunnel)
    └── tunnel_watchdog.sh (auto-restart)

relay.memplato.com (Vultr VPS)
└── nginx + relay.py
    └── Bridges AI clients to your phone
    └── No data stored

---

为什么不发布到 Play Store？

MemPlato 需要 Termux。由于 Android 对终端应用的限制，Termux 需要通过侧载安装。Google Play 上的 Termux 版本已过时且不兼容。这是当前 MVP 架构的已知限制。

计划： 获得资金支持后，MemPlato v2 将无需 Termux 即可运行——服务会直接嵌入应用中。无需配置终端，也无需手动操作。直接发布到 Google Play。

---

路线图

• MVP — Flutter 应用 + Python 服务 + MCP SSE
• APK 内捆绑所有软件包 — 设置无需联网
• 通过中继建立反向 SSH 隧道
• 29 个 MCP 工具
• 英语 + 乌克兰语本地化
• v2 — 服务嵌入应用，无需 Termux
• v2 — 在多部手机、电脑和云端之间同步
• 发布到 Google Play
• 更好的嵌入模型
• 在应用中手动启动/停止服务
• 手机开机时自动启动

---

支持此项目

MemPlato 由一位独立创始人开发。如果你觉得它有用，可以通过以下方式支持此项目：

• ⭐ 为此仓库点星 — 这比你想象的更有帮助
• 🐛 报告错误 — 提交 Issue
• 💬 分享反馈 — 你会用到哪些功能？
• 💰 赞助 — GitHub Sponsors （即将推出）

正在寻求 75K 美元的种子前融资。 助力项目登陆 Google Play 并发展至 10,000 名用户。请联系：[email protected] 或 memplato.com

---

许可证

AGPL-3.0 — 可免费使用和修改，但衍生作品必须继续保持开源。

---

在乌克兰用 ☕ 制作 🇺🇦