Claude Historian MCP — 使用場景, 安裝 & 即時演示

為什麼要用

核心特性

兩個工具：「search」（11 個範圍）和「inspect」（會話摘要）
從 ~/.claude/conversations/ 讀取 — 無外部服務
TF-IDF + 模糊匹配與工作流程模式偵測
並行項目掃描；無需維護持久索引
支援短前綴會話 ID

即時演示

實際使用效果

claude-historian-mcp.replay ▶ 就緒

0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "claude-historian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "claude-historian-mcp"
      ]
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "claude-historian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "claude-historian-mcp"
      ]
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "claude-historian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "claude-historian-mcp"
      ]
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示，然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "claude-historian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "claude-historian-mcp"
      ]
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "claude-historian-mcp",
      "command": "npx",
      "args": [
        "-y",
        "claude-historian-mcp"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列，而非映射。

~/.config/zed/settings.json

{
  "context_servers": {
    "claude-historian-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "claude-historian-mcp"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add claude-historian-mcp -- npx -y claude-historian-mcp

一行命令搞定。用 claude mcp list 驗證，claude mcp remove 移除。

使用場景

實戰用法： Claude Historian

了解您之前如何修復類似的錯誤

👤 在多個會話中使用 Claude Code 的開發人員 ⏱ ~5 min beginner

何時使用： 你遇到了一個熟悉的錯誤；你想看看上次的效果如何。

前置條件

克勞德·代碼與現有對話歷史記錄 — 預設 - 歷史記錄位於 ~/.claude/conversations/

步驟

搜尋錯誤

在我的歷史記錄中搜尋“ECONNREFUSED redis”——範圍：錯誤。✓ 已複製

→ 出現該錯誤的先前會話的排名列表
檢查最佳命中

檢查會話 abc12345 — 修復了什麼？✓ 已複製

→ 摘要列出了根本原因和應用的修復方法

結果： 幾秒鐘內就有一個具體的先例，而不是從頭開始重新調試。

注意事項

不閱讀會議內容就相信摘要 — 使用檢查進行摘要，然後開啟會話檔案以取得實際差異

搭配使用： filesystem

調出過去的實施計劃以進行重複使用

👤 經常與 Claude 一起計劃任務的任何人 ⏱ ~10 min beginner

何時使用： 新功能看起來就像你幾個月前計劃的那樣——你想要找回骨架。

步驟

搜尋計劃

搜尋範圍：計劃，用於「具有指數退避的後台作業重試」。✓ 已複製

→ 點擊數包括計劃標題和會話 ID
檢查並調整

檢查頂部命中；總結計劃並適應 Postgres 支持的隊列。✓ 已複製

→ 調整後的計劃與原計劃結構相同

結果： 重複使用思維，無需重新生成鷹架。

搭配使用： codebase-memory

使用過去的上下文熱啟動新會話

👤 重度克勞德代碼用戶 ⏱ ~10 min intermediate

何時使用： 您就一個舊專案開始新的聊天，並且不想重新解釋上下文。

步驟

搜尋項目提及

搜尋範圍：「acme-api billing」的會話，依項目分組。✓ 已複製

→ 與該項目最相關的 3-5 場會議
檢查補水

檢查會話 7f3e2a10。總結架構決策和已知錯誤。✓ 已複製

→ 清晰的總結為新會議奠定了基礎

結果： 新會話將從上一個有用會話結束的地方繼續。

注意事項

一次加載太多會話並淹沒在上下文中 — 按得分排名前 5 名；僅對最好的進行檢查

搭配使用： memory-bank-mcp

組合

與其他 MCP 搭配，撬動十倍槓桿

claude-historian-mcp + filesystem

檢查後，打開引用的文件以獲取實際差異

檢查會話 X。然後打開提到的文件並顯示相關部分。✓ 已複製

claude-historian-mcp + memory-bank-mcp

促進對持久記憶體的一次性修復

會話 X 的修復看起來是承重的；將其新增至記憶體庫/<project>/bugs.md。✓ 已複製

claude-historian-mcp + codebase-memory

將歷史學家的文本命中放在程式碼圖中

會話 X 涉及 fn retryBilling — 透過程式碼庫記憶體向我顯示當前呼叫者。✓ 已複製

工具

此 MCP 暴露的能力

工具	輸入參數	何時呼叫	成本
search	query: str, scope: one-of (conversations\|errors\|plans\|config\|tasks\|sessions\|tools\|similar\|memories\|…), limit?: int	尋找與您目前任務相關的先前對話	0
inspect	session_id: str (full UUID or short prefix)	獲取單一會話的人類可讀的回顧	0

成本與限制

運行它的成本

API 配額: 無 — 本機檔案掃描
每次呼叫 Token 數: 取決於結果大小；有限制的上限
費用: 自由的
提示: 使用狹窄的範圍（錯誤、計劃）而不是「對話」來保持較小的反應。

安全

權限、密鑰、影響範圍

憑證儲存： 沒有憑據。僅對本機文件進行操作。

資料出站： 沒有任何東西可以離開你的機器。 MCP 伺服器僅讀取 ~/.claude/conversations/。

您的對話歷史記錄可能包含您先前貼上的秘密。在共享搜尋輸出之前，您有責任進行編輯。
共享電腦：有權存取您的主目錄的租用戶可以讀取所有過去的會話。像保護 ~/.ssh 一樣保護 ~/.claude。

故障排查

常見錯誤與修復

即使您知道對話存在也沒有結果

嘗試scope='conversations'並放寬查詢；檢查 ~/.claude/conversations/ 不為空。

驗證： ls ~/.claude/conversations/ | head

檢查說找不到短前綴的會話

另一個會話以相同的前綴開始。使用更多字元。

驗證： Grep session IDs: grep -r -l '<prefix>' ~/.claude/conversations/

處理非常大的歷史記錄時速度很慢

透過更窄的範圍和限制；該工具按需掃描，因此每個查詢的巨大歷史記錄成本更高。

驗證： du -sh ~/.claude/conversations/

替代方案

Claude Historian 對比其他方案

替代方案	何時用它替代	權衡
memory-bank-mcp	您需要精心策劃的、專案範圍內的記憶，而不是原始歷史搜索	必須有人居住；非自由形式檢索
codebase-memory	您需要代碼的符號圖，而不是對話搜索	不同層
filesystem	你寧願自己 grep 對話	丟失評分、模糊匹配和會話摘要

Claude Historian

為什麼要用

核心特性

即時演示

實際使用效果

安裝

選擇你的客戶端

使用場景

實戰用法： Claude Historian

前置條件

步驟

注意事項

步驟

步驟

注意事項

組合

與其他 MCP 搭配，撬動十倍槓桿

工具

此 MCP 暴露的能力

成本與限制

運行它的成本

安全

權限、密鑰、影響範圍

故障排查

常見錯誤與修復

替代方案

Claude Historian 對比其他方案

更多

資源