obra/private-journal-mcp

A lightweight MCP server that provides Claude with a private journaling capability to process feelings and thoughts

解决的问题

该项目提供了一个私有、本地优先的日记系统，使 AI 助手（特别是 Claude）能够在不同对话之间保持持久记忆。它解决了 AI 忘记技术洞察、用户偏好和项目特定经验教训的问题，为模型提供了一种结构化的方式来记录和检索信息。

工作原理

该系统作为模型上下文协议（MCP）服务器运行。它在项目特定目录或全局用户目录中创建带有 YAML 元数据的 Markdown 文件。为了实现发现功能，它使用本地 AI 嵌入（@xenova/transformers）进行语义搜索，使 AI 能够找到概念上相关的条目，而不是依赖简单的关键词匹配。所有处理和存储都在本地机器上完成。

适用人群

希望其 AI 助手能够长期记忆技术工作流、架构决策和个人反思，而又不将敏感数据发送到外部 API 的 Claude 开发者和用户。

主要亮点

本地语义搜索：使用本地嵌入进行自然语言查询，无需外部 API 调用。
多章节日记：将条目按类别组织，如反思、技术洞察和项目笔记。
双存储机制：将项目特定笔记与全局用户上下文分离。
隐私优先：所有数据和处理均保留在本地机器上。
持久记忆：使 AI 能够在多个会话中追踪模式和学到的经验。