mindpm
LLM的持久项目内存。 永远不要再解释你的项目。
mindpm是一个MCP(模型上下文协议)服务器,为LLM的项目提供SQLite支持的大脑。它跟踪任务、决策、架构注释和会话上下文,因此每一次新的对话都会准确地从你停止的地方开始。
问题
每个新的LLM聊天都从零开始:
- *“让我提醒你我的项目……”*
- *“上次我们决定使用Redis…”*
- *“我们在哪里停下来的?”*
解决方案
mindpm将您的项目状态保存在本地SQLite数据库中。LLM通过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."它追踪什么
- 任务 --状态、优先级、阻止程序、子任务
- 决策 --决定了什么,为什么,拒绝了哪些替代方案
- 备注 --架构、bug、想法、研究
- 上下文 --键值对(技术栈、约定、配置)
- 会话 --做了什么,下一步是什么
用看板图
mindpm包括一个内置的看板UI。当MCP服务器启动时,它在以下位置提供web界面 http://localhost:3131.
每 start_session 调用将返回指向项目板的直接链接:
Kanban board: http://localhost:3131?project=
端口可通过以下方式配置 MINDPM_PORT 环境变量。
设置
安装
npm install -g mindpm或者从源代码运行:
git clone https://github.com/umitkavala/mindpm.git
cd mindpm
npm install
npm run build配置您的MCP客户端
所有客户端都使用相同的JSON格式,只是配置文件位置不同。他们都有同样的东西 ~/.mindpm/memory.db,这样您就可以在项目中期切换工具,而不会丢失上下文。
克劳德代码 — ~/.claude/claude_desktop_config.json
{
"mcpServers": {
"mindpm": {
"command": "mindpm",
"env": {
"MINDPM_DB_PATH": "~/.mindpm/memory.db",
"MINDPM_PORT": "3131"
}
}
}
}或者使用一个衬垫:
claude mcp add mindpm -e MINDPM_DB_PATH=~/.mindpm/memory.db -- npx -y mindpm光标 — .cursor/mcp.json 在项目根目录中(或 ~/.cursor/mcp.json 全球)
{
"mcpServers": {
"mindpm": {
"command": "npx",
"args": ["-y", "mindpm"],
"env": {
"MINDPM_DB_PATH": "~/.mindpm/memory.db"
}
}
}
}VS代码+副本 — .vscode/mcp.json 在项目根目录中
{
"servers": {
"mindpm": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mindpm"],
"env": {
"MINDPM_DB_PATH": "~/.mindpm/memory.db"
}
}
}
}克莱恩 --通过VS代码设置添加→ 克莱恩→ MCP服务器,或编辑 cline_mcp_settings.json:
{
"mcpServers": {
"mindpm": {
"command": "npx",
"args": ["-y", "mindpm"],
"env": {
"MINDPM_DB_PATH": "~/.mindpm/memory.db"
}
}
}
}帆板运动 --设置→ 级联→ MCP,使用与上面Cline相同的JSON结构。
将mindpm用于任何LLM
mindpm在第一轮中写道 ~/.mindpm/AGENT.md -一个现成的粘贴系统提示,告诉你的LLM如何主动使用mindpm。将其内容粘贴到客户的自定义说明或系统提示框中。
您也可以致电 get_agent_instructions 工具随时检索指令。
开始使用
就是这样。法学硕士现在可以使用mindpm工具。开始谈论你的项目。
MCP工具
项目
| 工具 | 说明 |
|---|---|
create_project | 创建新项目 |
list_projects | 列出所有项目 |
get_project_status | 完整项目概述 |
任务
| 工具 | 说明 |
|---|---|
create_task | 添加任务 |
update_task | 更新状态、优先级等。 |
list_tasks | 带过滤器的列表 |
get_task | 包含子任务和注释的完整任务详细信息 |
get_next_tasks | 智能:最高优先级,畅通无阻 |
决策
| 工具 | 说明 |
|---|---|
log_decision | 用推理记录决策 |
list_decisions | 浏览决策历史记录 |
注释和上下文
| 工具 | 说明 |
|---|---|
add_note | 添加注释(架构、bug、想法等) |
search_notes | 全文搜索 |
set_context | 存储键值上下文 |
get_context | 检索上下文 |
会话
| 工具 | 说明 |
|---|---|
start_session | 获取完整的项目背景+上一节课的下一步 |
end_session | 记录摘要+下次要做什么 |
查询
| 工具 | 说明 |
|---|---|
query | 针对数据库的只读SQL |
get_project_summary | 按状态、阻止程序、最近活动列出的任务 |
get_blockers | 所有被阻塞的任务及其阻塞原因 |
search | 所有内容的全文搜索 |
运作原理
┌─────────────┐ MCP ┌─────────┐ SQLite ┌──────────┐
│ Claude Code │ ◄──────────► │ mindpm │ ◄────────────► │ memory.db│
│ / Desktop │ tools │ server │ read/write │ │
└─────────────┘ └─────────┘ └──────────┘- 你开始对话并提到你的项目
- LLM电话
start_session→ 获取完整上下文 - 在对话过程中,它创建任务、记录决策、添加注释
- 当你完成时,它会召唤你
end_session→ 保存下一个内容 - 下一个对话:即时上下文,零重复解释
存储
违约: ~/.mindpm/memory.db
覆盖 MINDPM_DB_PATH 或 PROJECT_MEMORY_DB_PATH 环境变量。
数据库和表在首次运行时自动创建。
发展
npm install
npm run build # Build with tsup
npm run typecheck # Type-check without emitting
npm run dev # Build in watch mode许可证
麻省理工学院
