Claude Code Conversation Search MCP

🚀 Claude Code 会話検索MCP

Claude Codeの会話を失うことはもうありません。 「そのバグ修正についてどこで話し合ったんだっけ？」という問いや、ターミナルを閉じたときに何時間ものコンテキストを失うことがなくなります。

npm install -g claude-code-conversation-search-mcp

すべてのプロジェクトで任意の会話を検索できます。

"データベースの問題についてどこで話し合った？"
"認証に関する会話を探す"
"昨日話したDockerの設定"

正確なプロジェクト、日付、および再開コマンドを即座に取得できます。

✨ 主な機能

• 失われた会話を見つける：重要な議論を見失うことはもうありません。
• すべてのプロジェクトを横断して検索：プロジェクトAで作業しているが、プロジェクトBの情報が必要な場合でも、ただ検索するだけです。
• 即座に再開：正確な claude --resume コマンドを取得して、中断したところから続けることができます。
• 自然言語対応：人に話しかけるように質問できます - 「そのDockerの会話を探す」など。
• 高速検索：数千の会話をミリ秒単位で検索できます。
• ゼロセットアップ：インストールすると、既存のClaude Codeですぐに動作します。

📦 インストール

ソースからのインストール

# リポジトリをクローン
git clone https://github.com/TonySimonovsky/claude-code-conversation-search-mcp.git
cd claude-code-conversation-search-mcp

# 依存関係をインストール
npm install

# プロジェクトをビルド
npm run build

# オプション: グローバルにリンク
npm link

🚀 クイックスタート

インストールすると、Claude Codeと自動的に設定されます。

npm install -g claude-code-conversation-search-mcp

任意のプロジェクトで作業しながら、すべてのプロジェクトを横断して検索できます。

🎯 推奨: Claude Codeとの強化統合

最適な検索結果とより良いClaude Codeとのインタラクションのために、これらの指示をグローバルな ~/.claude/CLAUDE.md ファイルに追加してください。

# ~/.claude/CLAUDE.mdに追加
echo "- When asked to use conversation-search, you must start searching from very wide queries, narrowing down step by step. When responding based on this mcp results output a human readable text with proper newlines instead of formatting json." >> ~/.claude/CLAUDE.md

これが役立つ理由

• より良い検索戦略：Claudeは広いクエリから始めて徐々に絞り込み、より関連性の高い結果を見つけます。
• 人間が読みやすい出力：生のJSONではなく、プロジェクトパス、日付、および再開コマンドを含む適切にフォーマットされたレスポンスを取得します。
• 改善されたユーザー体験：Claude Codeのワークフロー内で会話検索が自然で直感的に感じられます。

💻 使用例

基本的な使用法

# 失われた会話を探す
"ログインバグについてどこで話し合った？"
"そのDockerの会話を探す"
"話したデータベースのセットアップ"

# 覚えていることで検索
"修正した認証エラー"
"昨日のAPIエンドポイントの議論"
"先週のパフォーマンス問題"

# 他のプロジェクトから解決策を見つける
"どのようにCORS問題を解決したか？"
"機能したRedisの設定"
"書いたデプロイメントスクリプト"

すべての検索で次の情報が得られます。

• 会話が行われたプロジェクト
• 会話が行われた日時
• 議論した内容（会話の要約）
• 再開するためのスマートなショートカット：cd ~/.cs/project-name && claude --resume abc123

高度な使用法

高度なクエリ

組み込みのクエリパーサーは、洗練された自然言語パターンをサポートしています。

# 特定のファイル操作を探す
"auth.jsを作成した場所はどこ？"

# 複数の条件で検索
"先週のバックエンドプロジェクトのデータベースマイグレーション"

# 特定のエラーパターンを探す
"ReactコンポーネントのTypeErrorまたはReferenceError"

# ツール操作を検索
"npmまたはyarnを含むbashコマンド"

# コードの議論を探す
"キャッシュの実装についてどこで話し合った？"

検索演算子

• AND：用語はデフォルトでAND条件になります（"auth login" は両方の用語を含むメッセージを検索します）。
• OR：用語の間に "or" を使用します（"auth or login"）。
• NOT： "-" プレフィックスを使用します（"auth -test" はテスト関連の結果を除外します）。
• フレーズ：正確なフレーズには引用符を使用します（"user authentication"）。
• ワイルドカード：接頭辞の一致には * を使用します（"auth*" はauth、authenticationなどに一致します）。

時間フィルター

サポートされる時間表現：

• today、yesterday
• last week、this week
• last month、this month
• last 7 days、last 30 days
• 特定の日付："on 2024-01-15"、"since January 1"

📚 ドキュメント

設定

自動設定（推奨）

インストール後、MCPサーバーはClaude Codeと自動的に設定されます。手動での設定は必要ありません！

手動設定（オプション）

カスタム設定が必要な場合は、次のアプローチから選択してください。 オプション1: コマンドライン（推奨）

# すべてのプロジェクトにグローバルに追加
claude mcp add conversation-search claude-code-conversation-search-mcp

# 現在のプロジェクトのみに追加（.mcp.jsonを作成）
claude mcp add --scope project conversation-search claude-code-conversation-search-mcp

オプション2: 設定ファイルを直接編集 グローバル設定（すべてのプロジェクト）

# グローバルなClaude Codeの設定を編集（どこからでも実行）
nano ~/.claude.json
# または好みのエディターを使用: code ~/.claude.json

{
  "mcpServers": {
    "conversation-search": {
      "command": "claude-code-conversation-search-mcp",
      "args": []
    }
  }
}

プロジェクト固有の設定（チーム共有）

# プロジェクト設定ファイルを作成（プロジェクトルートから実行）
nano .mcp.json
# または: code .mcp.json

{
  "mcpServers": {
    "conversation-search": {
      "command": "claude-code-conversation-search-mcp",
      "args": []
    }
  }
}

設定オプション

MCPサーバーは、環境変数を通じて幅広い設定をサポートしています。以下は最も一般的に使用されるオプションです。

📖 完全な設定オプションとパフォーマンスチューニングについては、設定ガイド を参照してください。

利用可能なツール

設定後、Claude Codeで次のツールが利用可能になります。

会話を検索

自然言語で会話履歴を検索します。

search_conversations("auth.jsを作成した場所はどこ？")
search_conversations("先週のデータベースの最適化")
search_conversations("index.tsのTypeError")

クエリ例

• ファイル操作："created auth.js"、"edited config.json"、"modified database.ts"
• トピック："discuss React hooks"、"security review"、"performance optimization"
• エラー："TypeError"、"CORS error"、"undefined variable"
• コマンド："npm install lodash"、"git commit"、"database migration"
• 時間フィルター："today"、"yesterday"、"last week"、"this month"
• プロジェクトフィルター："in project myapp"、"from backend-api" パラメーター
• query（必須）：自然言語の検索クエリ
• limit（オプション）：返す最大結果数（デフォルト: 10）
• includeContext（オプション）：周囲のメッセージを含める（デフォルト: true）

プロジェクトを一覧表示

統計情報付きですべてのインデックスされたプロジェクトを取得します。

list_projects()

プロジェクト名、メッセージ数、および最後のアクティビティ日付を返します。

メッセージのコンテキストを取得

特定のメッセージの周囲の完全なコンテキストを取得します。

get_message_context("msg_abc123", contextSize: 5)

パラメーター

• messageId（必須）：コンテキストを取得するメッセージID
• contextSize（オプション）：前後のメッセージ数（デフォルト: 5）

会話のメッセージを取得

特定の会話からメッセージを取得します。

get_conversation_messages("conv_456", limit: 50, startFrom: 0)
get_conversation_messages("conv_456", limit: 10, startFrom: -1)  # 最後の10件のメッセージ
get_conversation_messages("conv_456", limit: 20, startFrom: -10) # 末尾から10番目から始まる20件のメッセージ

パラメーター

• conversationId（必須）：メッセージを取得する会話ID
• limit（オプション）：返すメッセージ数（デフォルト: 50）
• startFrom（オプション）：開始位置 - 0=最初、-1=最後、-10=末尾から10番目（デフォルト: 0）

ツールを一覧表示

利用可能なすべてのツールとそのシグネチャを表示します。

list_tools()

自動生成されたツールのシグネチャと説明を返します。新しいツールが追加されると自動的に更新されます。

インデックスを更新

手動で再インデックス作成をトリガーします。

refresh_index()

新しいプロジェクトを追加した後、または自動インデックス作成が無効になっている場合に役立ちます。

サーバー情報を取得

サーバーのバージョン、変更履歴、およびシステム情報を表示します。

get_server_info()

現在のバージョン、最近の変更、システムの状態、および利用可能なツールを表示します。

🔧 技術詳細

• 構築言語：TypeScript
• 検索エンジン：SQLite FTS5
• 統合方式：Model Context Protocol

システム要件

• Node.js 18+
• MCPをサポートするClaude Code
• macOS、Linux、またはWindows

パフォーマンス

• 10,000件以上の会話をサブ秒で検索
• ファイル監視によるリアルタイムインデックス作成
• 最小限のメモリ使用量（約50MB）

ストレージ

• ~/.claude/conversation-search/ にあるSQLiteデータベース
• 会話内容をインデックス化し、ファイル内容ではありません
• 削除された会話の自動クリーンアップ

📄 ライセンス

MITライセンス - 詳細については LICENSE ファイルを参照してください。

謝辞

このプロジェクトは、Anthropicによる Model Context Protocol SDK を使用して構築されています。

クレジット

開発者: Tony AI Champ & Claude Code, 09-2025

サポート

問題、機能要求、または質問については、以下の方法で対応します。

• GitHub で問題を報告する
• 既存の問題を確認して解決策を探す
• バグを報告する際にはデバッグログを含める

トラブルシューティング

データベースの問題

検索インデックスが破損した場合：

# データベースファイルを削除
rm ~/.claude/conversation-search.db

# Claude Codeを再起動して再インデックス作成をトリガー

パフォーマンスの最適化

大規模な会話履歴の場合：

1. INDEX_INTERVAL を増やしてインデックス作成の頻度を減らす
2. MAX_RESULTS を設定して結果のサイズを制限する
3. クエリで特定のプロジェクトフィルターを使用する

デバッグモード

問題をトラブルシューティングするためにデバッグログを有効にする：

{
  "mcpServers": {
    "conversation-search": {
      "command": "npx",
      "args": ["claude-code-conversation-search-mcp"],
      "env": {
        "DEBUG": "true"
      }
    }
  }
}