Memoir

io.github.bighippoman由 GitHub 帳號 bighippoman 發布v1.0.3更新於 Oct 24, 2026

Structured session journals for AI agents. Persistent memory across sessions.

已驗證STDIO僅桌面知識與記憶開發者工具

概覽

AI 產生的概覽

Memoir 是本地 MCP 伺服器，為 AI 代理保存結構化的工作階段日誌，讓新工作階段能接續上次的進度。

可以做什麼
  • 記錄目前工作階段中嘗試過的做法與結果、阻礙點、阻礙解除情況及設計決策
  • 以選用摘要結束目前工作階段
  • 讀取上一次工作階段的結構化交接：嘗試了什麼、卡在哪裡、做了哪些決定
  • 查詢過去的工作階段，並列出跨工作階段的未解決或已解決阻礙
  • 依 git 根目錄自動判定專案範圍，並以滾動保留策略清除舊工作階段
適用情境
適合長期進行的程式開發專案：每次新的代理工作階段原本都得從頭開始，容易重複死路、失敗做法或被遺忘的決定。也適合希望以輕量、本機方式記錄嘗試過程與原因的開發者。
執行需求
透過 stdio 在本機執行，通常以 npx 啟動，因此需要 Node.js。不需要 API 金鑰或外部服務，資料存放在使用者家目錄下的單一 SQLite 檔案。可選環境變數 MEMOIR_MAX_CONTENT、MEMOIR_MAX_OUTCOME、MEMOIR_MAX_ENTRIES 與 MEMOIR_MAX_SESSIONS 可調整長度上限與保留數量。
安裝前請注意
助理會將日誌項目寫入本機資料庫，且達到滾動上限後舊工作階段會自動清除，較早的歷史可能遺失。項目可能包含專案細節，分享該資料庫或其內容前請先確認記錄了哪些資訊。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Memoir，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

memoir-mcp

Structured session journals for AI agents. Persistent memory across sessions -- no more repeating dead ends.

When a session ends, all reasoning is lost -- what was tried, what failed, what's blocked. The next session starts from scratch and repeats the same mistakes. memoir logs it all and hands it off so the next session picks up where the last one left off.

Works with any MCP client: Claude Code, Cursor, Codex, Windsurf, and more.

[memoir-mcp MCP server]

Install

Claude Code

bash
claude mcp add memoir -s user -- npx -y memoir-mcp

Other MCP clients

bash
npx -y memoir-mcp

How it works

  • Automatic project detection -- identifies the project by its git root, so logs stay scoped without any configuration.
  • Implicit sessions -- a session is created automatically on first log. No setup step.
  • Rolling retention -- keeps the last 20 sessions per project (configurable). Old sessions are pruned automatically.

Tools

Write

ToolDescription
log_attemptRecord something that was tried and its outcome.
log_blockerFlag something that's stuck and why.
resolve_blockerMark a blocker as resolved with what fixed it.
log_decisionRecord a design or architecture choice and its rationale.
end_sessionClose the current session with an optional summary.

Read

ToolDescription
get_handoffStructured summary of the last session -- what was attempted, what's blocked, what was decided.
get_historyQuery past sessions (default: last 3, max 20).
get_blockersList unresolved (or resolved) blockers across all sessions.

Storage

Single SQLite file at ~/.memoir/memoir.db. No API keys, no external services.

Configuration

All limits are configurable via environment variables:

VariableDefaultDescription
MEMOIR_MAX_CONTENT500Max characters for content fields
MEMOIR_MAX_OUTCOME300Max characters for outcome/resolution fields
MEMOIR_MAX_ENTRIES50Max entries per session
MEMOIR_MAX_SESSIONS20Max sessions per project (rolling)

Example with custom limits:

bash
claude mcp add memoir -s user -e MEMOIR_MAX_CONTENT=1000 -e MEMOIR_MAX_ENTRIES=100 -- npx -y memoir-mcp

Handoff output uses a compact format to keep context window usage low.

License

MIT

來源：README.md，提交 7c31ada

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.3最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分