作者 Vvkmnn · Vvkmnn/claude-historian-mcp
自分のクロード コード履歴を検索します。別のインデックスを使用せずに、過去の解決策、エラー、計画、セッションを見つけます。
claude-historian-mcp は、ローカルの ~/.claude/conversations/ を検索可能なコーパスとして扱います。 2 つのツール: TF-IDF にヒントを得たスコアリング、ファジー マッチング、およびワークフロー パターン検出を使用して、11 のスコープ (会話、エラー、計画、構成、タスク、セッション、ツール、類似のクエリ、思い出など) にわたるクエリを「検索」します。 「inspect」は、完全な UUID または短いプレフィックスによるセッションのインテリジェントな概要を返します。 永続的なインデックスはありません。オンデマンドでプロジェクトを並行して処理します。 これを使用して、同じバグの再解決を回避したり、計画を再利用したり、半分覚えていたコマンドを表面化したりできます。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"claude-historian-mcp": {
"command": "npx",
"args": [
"-y",
"claude-historian-mcp"
]
}
}
}Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。
{
"mcpServers": {
"claude-historian-mcp": {
"command": "npx",
"args": [
"-y",
"claude-historian-mcp"
]
}
}
}Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。
{
"mcpServers": {
"claude-historian-mcp": {
"command": "npx",
"args": [
"-y",
"claude-historian-mcp"
]
}
}
}Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。
{
"mcpServers": {
"claude-historian-mcp": {
"command": "npx",
"args": [
"-y",
"claude-historian-mcp"
]
}
}
}Claude Desktop と同じ形式。Windsurf を再起動して反映。
{
"mcpServers": [
{
"name": "claude-historian-mcp",
"command": "npx",
"args": [
"-y",
"claude-historian-mcp"
]
}
]
}Continue はマップではなくサーバーオブジェクトの配列を使用。
{
"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 で削除。
使うタイミング： 見覚えのあるエラーが発生しています。 前回何が機能したかを確認したいとします。
結果： ゼロからの再デバッグではなく、数秒で具体的な前例が得られます。
使うタイミング： 新しい機能は数か月前に計画したものと似ていますが、骨格を元に戻したいと考えています。
結果： 足場を再生成せずに思考を再利用します。
使うタイミング： 古いプロジェクトについて新しいチャットを開始しますが、コンテキストを再説明したくないとします。
結果： 新しいセッションは、最後に有用なセッションが中断したところから再開されます。
検査後、参照ファイルを開いて実際の差分を確認します。
1 回限りの修正を永続的なメモリに促進する
歴史家のテキスト ヒットをコード グラフに根拠付ける
| ツール | 入力 | 呼び出すタイミング | コスト |
|---|---|---|---|
| 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 |
会話が存在することがわかっていても結果が得られないscope='conversations' を試してクエリを緩和してください。 ~/.claude/conversations/ が空でないことを確認してください。
ls ~/.claude/conversations/ | headInspect で短いプレフィックスのセッションが見つからないと表示される別のセッションは同じプレフィックスで開始されます。 もっと多くの文字を使用してください。
Grep session IDs: grep -r -l '<prefix>' ~/.claude/conversations/非常に大きな履歴では遅いより狭い範囲と制限を通過します。 このツールはオンデマンドでスキャンするため、履歴が膨大になるとクエリごとのコストが高くなります。
du -sh ~/.claude/conversations/| 代替案 | 代わりに使う場面 | トレードオフ |
|---|---|---|
| memory-bank-mcp | 生の履歴検索ではなく、厳選されたプロジェクト スコープのメモリが必要な場合 | 入力する必要があります。 自由形式の検索ではない |
| codebase-memory | 会話検索ではなく、コードのシンボル グラフが必要です | 異なるレイヤー |
| filesystem | 自分で会話を grep するほうがよいでしょう | スコアリング、ファジーマッチング、セッションサマリーの喪失 |