Claude Historian

🚀 claude-historian

Claude Codeの会話履歴を検索するためのモデルコンテキストプロトコル（MCP）サーバーです。過去の解決策を見つけ、ファイルの変更を追跡し、以前の作業から学ぶことができます。

🚀 クイックスタート

必要条件

• Claude Code

インストール方法

シェルからのインストール

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

Claude内からのインストール（再起動が必要）

Add this to our global mcp config: npx claude-historian

Install this mcp: https://github.com/Vvkmnn/claude-historian

手動で設定可能なmcp.jsonからのインストール（Cursor、Windsurfなど）

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

以上です。npm installは必要ありません。外部依存関係やローカルデータベースはなく、検索アルゴリズムのみで動作します。

✨ 主な機能

MCPサーバーを介して、Claudeが会話履歴にアクセスできるようにします。スマートな優先順位付けによる高速検索が可能です。

ローカルで実行されます（クールなアイコン[⌐■_■]付き）：

[⌐■_■] search_conversations query=<query>
  > "How did we fix that Redis connection pooling nightmare?"
  > "Docker container keeps crashing on Kubernetes deployment"
  > "React infinite re-render loop - useEffect dependency hell"

[⌐□_□] find_file_context filepath=<filepath>
  > "package.json changes that broke everything last month"
  > "When we accidentally committed .env to main branch"
  > "Authentication service refactor - before/after comparison"

[⌐×_×] get_error_solutions error_pattern=<error>
  > "MODULE_NOT_FOUND - the classic npm/yarn version mismatch"
  > "CORS preflight failing - but only on production Fridays?"
  > "Database deadlock during Black Friday traffic spike"

[⌐◆_◆] find_similar_queries query=<query>
  > "Database queries slower than my morning coffee brewing"
  > "How to implement error boundaries without losing sanity"
  > "State management: Redux vs Zustand vs just useState"

[⌐○_○] list_recent_sessions
  > "Tuesday debugging marathon: 9pm-3am flaky test hunt"
  > "Performance optimization sprint - reduced bundle 40%"
  > "The great TypeScript migration of 2024"

[⌐⎚_⎚] find_tool_patterns tool_name=<tool>
  > "Read → Edit → Bash combo for rapid prototyping"
  > "When I use Grep vs Task for different searches"
  > "Git operations during feature branch management"

🔧 技術詳細

claude-historianの動作原理 (ソース):

"docker auth" query
      |
      ├─> Classify: implementation query -> boost tool examples
      |
      ├─> Stream & Filter:
      |   • Summary messages -> priority queue *****
      |   • Tool usage context -> high value ****
      |   • Error solutions -> targeted ***
      |
      ├─> Smart Ranking:
      |   • "Fixed Docker auth with Read tool" (2h ago) *****
      |   • "OAuth implementation approach" (yesterday) ****
      |   • "Container auth debug" (last week) ***
      |
      └─> Return Claude Code optimized results

以下の技術を用いた純粋なストリーミングアーキテクチャ:

• JSON streaming parser: Claude Codeの会話ファイルを完全にデシリアライズせずに必要に応じて読み取ります。
• LRU caching: 頻繁にアクセスされる会話をインメモリキャッシュに保持し、スマートなエビクションを行います。
• TF-IDF inspired scoring: 関連性を考慮した用語頻度スコアリングを行います。
• Query classification: ナイーブベイズスタイルの分類（エラー/実装/分析/一般）を行い、適応的な制限を設定します。
• Edit distance: 技術用語の曖昧なマッチングとタイプミスの許容を行います。
• Exponential time decay: 最近のメッセージに重み付けを行い、半減期を設定可能です。

ファイルアクセス:

• 読み取り元: ~/.claude/conversations/
• 永続的なストレージやインデックスは使用しません。
• マシンからデータは一切送信されません。

💻 開発方法

git clone https://github.com/vvkmnn/claude-historian && cd claude-historian
npm install && npm run build
npm test

コントリビューションについて

• リポジトリをフォークし、機能ブランチを作成してください。
• 大規模な会話履歴でテストを行ってからPRを提出してください。
• TypeScriptのstrictモードとMCPプロトコルの標準に従ってください。

サンプルから学ぶ

• 参考実装として公式MCPサーバーを参照してください。
• ベストプラクティスとしてTypeScript SDKを参照してください。

📄 ライセンス

MIT

Claude Fauchet (1744-1793), French Historian