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 能在多個會話中追蹤模式與學到的教訓。