Mindpm

mindpm

AI 编码 Agent 的项目记忆与控制平面。

mindpm 是一个 MCP（Model Context Protocol）服务，为大模型提供由 SQLite 支持的项目大脑。它会跟踪任务、决策、架构笔记和会话上下文，让每次新对话都能准确接续上次的进度。它还会将有规格说明的任务交给编码 Agent，避免并行 Agent 相互冲突，并且只有在人类验收后才将工作计为完成。对于无人值守运行的 Agent，还可以启用可选的验证器，先自行重新运行检查。

问题

每次新的大模型聊天都从零开始：

• “让我先向你介绍一下我的项目……”
• “上次我们决定使用 Redis 来……”
• “我们上次进行到哪里了？”

解决方案

mindpm 将项目状态保存在本地 SQLite 数据库中。大模型通过 MCP 工具读取和写入数据。无需聊天记录，也无需记忆功能。

You: "What should I work on next?"
LLM: [queries mindpm] "Last session you finished the auth refactor.
      You have 3 high-priority tasks: rate limiting, API docs, and
      the webhook retry bug. Rate limiting is unblocked — start there."

跟踪内容

• 任务、规格说明和验收标准，包括交接状态、优先级和阻塞项
• 决策：决定了什么、原因是什么，以及否决了什么
• 笔记和上下文：架构、错误、想法、技术栈和约定
• 会话：已完成的工作和接下来的事项，以及你离开期间的变更摘要
• Agent 尝试记录：每项任务的每次运行记录，以及下一次尝试应避免的事项

快速开始

claude mcp add mindpm -e MINDPM_DB_PATH=~/.mindpm/memory.db -- npx -y mindpm

这是 Claude Code；npx 会获取 mindpm，因此无需预先安装。Claude Desktop、Cursor、VS Code、Cline 和 Windsurf 使用相同的 JSON 配置，只是放在不同的文件中。然后只需聊聊你的项目。大模型会调用 start_session 加载上下文，在你工作时记录任务、决策和笔记，并调用 end_session 保存接下来的事项。看板运行在 http://localhost:3131。

工作原理

┌──────────────┐     MCP      ┌─────────┐     SQLite     ┌───────────┐
│ Claude Code, │ ◄──────────► │ mindpm  │ ◄────────────► │ memory.db │
│ Cursor, ...  │    tools     │ server  │   read/write   │           │
└──────────────┘              └─────────┘                └───────────┘

所有数据都保存在你的设备上，存储于一个 SQLite 文件中（默认路径为 ~/.mindpm/memory.db）。mindpm 还可以将有规格说明的任务交给没有对话上下文的编码 Agent：通过带租约的认领机制避免并行 Agent 相互冲突，你可以在看板上验收提交的工作。对于无人值守运行的 Agent，还可以启用可选的验证器，先对每个提交的更改重新运行检查。

安全性： mindpm 没有用户账户，也无法阻止你自己设备上的进程。拥有 shell 的 Agent 可以像你一样调用看板的路由，也可以直接编辑数据库。让 Agent 无人值守运行前，请阅读安全模型。

文档

完整文档：https://umitkavala.github.io/mindpm/

• 设置：适用于各种 MCP 客户端、适用于任何大模型的 Agent 指令、存储
• 看板：工作泳道、验收工作、网络绑定和 WSL
• 会话摘要：你离开期间的变更
• Agent 执行：生命周期、规格说明、认领和摘要
• 进阶：无人值守 Agent 与验证
• 安全模型
• MCP 工具
• 开发
• 更新日志

许可证

MIT