个人背景MCP
Claude Desktop的Markdown优先MCP,使AI内存便携、结构化和用户所有。
如果克劳德能在你真正拥有的记忆系统中醒来呢?
personal-context-mcp 为Claude提供了一个Markdown上下文的本地文件夹:持久真理、实时优先级、粗略笔记和可审查的更新。克劳德可以搜索它,在工作开始前建立一个专注的简报,并捕捉新的观察结果,而不会意外地将其变成永久的真理。
与信任不透明的应用程序内存不同,你会得到一个小的个人上下文层,你可以检查、编辑、版本、复制和随身携带。
10秒版本
没有这一点:每一次重要的聊天都始于你重新解释你是谁,什么很重要,你是如何工作的,以及目前正在发生什么。
有了这个:克劳德可以跑了 wake_up_context,首先阅读正确的本地Markdown部分,然后从重要的上下文开始任务。
行动中
Personal Context MCP in Claude Desktop
最酷的部分是循环:搜索重要的东西,用正确的捆绑包醒来,安全地捕捉粗略的笔记,然后只推广赢得信任的作品。
您想在五分钟内完成产品的成型吗?阅读 V2演示演练.
为什么使用它
这在以下情况下最有用:
- 大量使用克劳德
- 在多个AI工作流之间切换
- 希望跨会话和项目保持连续性
- 关注用户拥有的内存,而不是产品拥有的内存锁定
- 希望重要上下文在普通文件中保持可审查性
是什么让这与众不同
这个项目故意固执己见:
- Markdown优先,因此内存层保持可移植性和可检查性
core / dynamic / inbox,所以持久的真理、工作记忆和试探性笔记不会混在一起- 人类可审查,因此重要的上下文在普通文件中可见和可编辑
- 具有信任意识,因此可以捕捉到粗略的笔记,而无需假装它们是持久的真理
- 默认情况下为本地,因此您已填写的投资组合仍在您的控制之下
关键不在于“更多的记忆”。这是一条从粗略的背景到有用的背景的更可检查的路径,同时保持持久的真理得到保护。
这是核心赌注:最好的AI记忆不是隐形的。它具有可读性、本地性和策划性。
V2表面
当前的V2界面将项目从基本的Markdown内存桥转变为更完整的个人上下文工作流程:
- 排名搜索:
search_memory查找具有透明排名原因的相关文件和部分。 - 唤醒包:
wake_up_context在任务开始之前构建一个小型的信任感知包,这样Claude就可以先读取正确的上下文。 - 持久的上下文包装:
writing_style_context,product_positioning_context,以及outbound_framing_context给常见的高价值提示明确的切入点。 - 手动摄入:
manual_ingest将粘贴的笔记、成绩单摘录和粗略摘要捕获到低信任度的收件箱内存中,并显示出处。 - 评审与推广:
promote_raw_note,mark_raw_note_status,以及link_raw_note_to_proposal让粗糙的笔记转移到可重复使用的内存中,而不会抹去它们的痕迹。 - 更安全的动态维护: 动态文件可以通过精确的节/项操作而不是广泛的重写来附加、引导或更新。
升级不仅仅是更多的工具。这是一个更紧密的循环:
- 问克劳德存在什么背景。
- 搜索并排名正确的Markdown部分。
- 构建一个专注的阅读优先包。
- 将粗略笔记捕获到低信任度收件箱内存中。
- 仅将已审阅的上下文提升到可重用的工作内存中。
内存模型
此项目使用一个简单的三层内存模型:
core/
持久的真理。身份、定位、沟通方式、操作规则。
dynamic/
工作记忆。当前的优先事项、活跃的活动、最近的学习、消息测试、帐户模式。
inbox/
低信任度笔记。粗略的观察、部分想法和拟议的核心更新。
这种分离是关键的设计选择:稳定的真理、不断发展的记忆和不确定的笔记不应该合并成一个blob。
刀具表面
| 工具 | 表面 | 用途 |
|---|---|---|
status | 只读 | 显示内存运行状况、可写表面和可用工具。 |
list_memory_files | 只读 | 列出克劳德可以检查的投资组合文件。 |
read_memory_file | 只读 | 读取一个特定的内存文件。 |
search_memory | 只读 | 搜索具有排名匹配项和排名原因的文件和部分。 |
wake_up_context | 只读 | 为任务构建一个紧凑的、支持信任的上下文包。 |
writing_style_context | 只读 | 提取用于起草、重写和编辑任务的写作风格上下文。 |
product_positioning_context | 只读 | 为战略或消息传递工作提取产品和定位上下文 |
outbound_framing_context | 只读 | 为潜在客户和外联工作提取出站框架上下文 |
manual_ingest | inbox/ write | 将粘贴的笔记捕获到具有出处的低信任度内存中。 |
append_memory_entry | dynamic/ write | 在批准的动态部分添加一个持久的学习内容。 |
maintain_dynamic_item | dynamic/ write | 替换或删除一个确切的项目符号或注明日期的条目。 |
replace_dynamic_section | dynamic/ write | 替换一个已批准的动态部分。 |
bootstrap_dynamic_memory | dynamic/ write | Bootstrap动态内存来自可重用的对话证据。 |
mark_raw_note_status | inbox/ write | 标记已审阅或推广的原始笔记,但不删除源笔记。 |
promote_raw_note | dynamic/ 或 inbox/ 写 | 将一个经过审查的原始笔记转化为学习或核心更新提案。 |
link_raw_note_to_proposal | inbox/ write | 将原始注释链接到现有的核心更新提案。 |
propose_core_update | inbox/ write | 提出受保护的核心更改,无需编辑 core/ 直接。 |
隐私边界
此回购中的初始投资组合故意为空白,可以安全复制。您填写的个人背景投资组合是私人数据。
不要将已填写的投资组合提交给公共回购。默认的快速启动名称, my-personal-context-portfolio/,被此仓库忽略,但如果您选择其他名称,请将其保留在Git之外或添加到您自己的名称中 .gitignore 在填写之前。
看 隐私.md 对于隐私模型。
需求
- 启用本地扩展的Claude Desktop
- Node.js 20或更新版本
- npm
安装
git clone https://github.com/abhinavkalyan10/personal-context-mcp.git
cd personal-context-mcp
npm install
npm run install:extension
npm run prepare:extension然后安装 .build/claude-extension/personal-context 作为Claude Desktop中的未打包扩展。
回购结构
.
├── assets/
├── desktop-extension/personal-context/
├── lib/
├── mcp/
├── scripts/
├── starter-personal-context-portfolio/
├── tests/
├── QUICKSTART.md
└── package.json这不是什么
这不是神奇的自主记忆。
它不会取代:
- 判决
- 选择性治疗
- 定期清理
- 持久真理的人工审查
它也不添加嵌入、矢量数据库、知识图或自动后台写入。
项目文档
- QUICKSTART.md:安装和验证演练
- docs/v2-demo-walkythrough.md:V2工作流程的简短导览
- 更改日志.md:发布历史记录
- 隐私.md:隐私模型和数据边界
- 安全.md:安全策略
建议的单行描述
Personal Context MCP是Claude Desktop的一个基于Markdown的便携式存储系统,它将持久上下文、工作记忆和低信任度笔记分开,这样AI助手就可以在不将内存困在一个产品中的情况下保持有用。
许可证
麻省理工学院
