使用说明
个人背景MCP
Claude Desktop的Markdown优先MCP，使AI内存便携、结构化和用户所有。
如果克劳德能在你真正拥有的记忆系统中醒来呢？
personal-context-mcp 为Claude提供了一个Markdown上下文的本地文件夹：持久真理、实时优先级、粗略笔记和可审查的更新。克劳德可以搜索它，在工作开始前建立一个专注的简报，并捕捉新的观察结果，而不会意外地将其变成永久的真理。
与信任不透明的应用程序内存不同，你会得到一个小的个人上下文层，你可以检查、编辑、版本、复制和随身携带。
10秒版本
没有这一点：每一次重要的聊天都始于你重新解释你是谁，什么很重要，你是如何工作的，以及目前正在发生什么。
有了这个：克劳德可以跑了 wake_up_context，首先阅读正确的本地Markdown部分，然后从重要的上下文开始任务。
行动中
最酷的部分是循环：搜索重要的东西，用正确的捆绑包醒来，安全地捕捉粗略的笔记，然后只推广赢得信任的作品。
您想在五分钟内完成产品的成型吗？阅读 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助手就可以在不将内存困在一个产品中的情况下保持有用。
许可证
麻省理工学院
