claude-lens

MCPサーバー。Claude Codeに過去すべてのセッションにわたる検索可能なメモリを提供します。

すべてのClaude CodeセッションJSONLファイルを、FTS5全文検索付きSQLiteデータベースにインデックス化します。Claudeは、会話の検索、過去のツール呼び出しの発見、プロジェクトや日付でのフィルタリング、以前に解決したエラーの検索を行うツールを利用できます。

仕組み

Claude Codeはセッションを~/.claude/projects/内のJSONLファイルとして保存します。claude-lensは起動時にこれらを解析し、FTS5検索インデックスを構築して、MCP経由で9つのツールを公開します。Claudeのエージェントループが自身の履歴を検索するタイミングを決定するため、手動での呼び出しは不要です。

これは受動的なRAGではなく、能動的想起です。Claudeは何を検索するかを決定し、結果を読み、フォローアップクエリでさらに深掘りできます。人間が検索エンジンを使うのと同じパターンであり、的を絞った複数のクエリが、盲目的な1回の検索に勝ります。

Related MCP server: conversation-search

ツール

インストール

git clone https://github.com/jasonpaulmichaels/claude-lens.git
cd claude-lens
bash scripts/install.sh

または手動で：

# Sync repo to runtime install location
rsync -a --exclude=node_modules --exclude=.git --exclude=test \
  ./ ~/.claude/mods/claude-lens/
cd ~/.claude/mods/claude-lens && npm install --omit=dev

# Register MCP server (user scope so it's available everywhere)
claude mcp add -s user claude-lens -- node ~/.claude/mods/claude-lens/src/index.js

install.shがこれを自動的に行います。ソースリポジトリはランタイムインストールとは分離されており、ソースを編集してinstall.shを再実行することでデプロイできます。

インストール後、Claude Codeを再起動してください。最初の起動ですべてのセッションがインデックス化されます（数分かかります）。以降の起動は増分のみです（5秒未満）。

使用方法

通常どおりClaude Codeを使用するだけです。過去のセッションからのコンテキストが役立つ場合、Claudeが自動的に検索します。直接尋ねることもできます：

• 先週は何をやっていた？

• betterclawの認証バグをどう修正した？

• cloudflareトンネルを設定したセッションを見つけて

• カーネルモジュールを再ビルドするために実行したコマンドは？

• listforgeで作業中に遭遇したエラーを表示して

要件

• Node.js 20+

• MCP対応のClaude Code

データ

• セッションのインデックス元：~/.claude/projects/

• データベースの保存先：~/.claude-lens/claude-lens.db

• サブエージェントのセッションはスキップされます

• DBを管理可能なサイズに保つため、ツール出力は500文字に切り詰められます

• ファイルのmtime追跡による増分インデックス化

ライセンス

MIT