Cursor History

Cursor History MCP

English | 中文 | Français | Español

AI に Cursor の履歴を検索させましょう。

既存の Cursor の会話には、数か月分の決定事項、バグ、修正、アーキテクチャに関するコンテキストがすでに含まれているかもしれません。このツールで事前に記録していなくても、MCP 対応アシスタントがそのコンテキストを見つけられるようにします。

cursor-history-mcp は、cursor-history のローカル履歴リーダーに Claude、Cursor、その他の MCP クライアントを接続します。自然言語を使って、ワークスペースをまたいだ会話テキストを検索したり、セッションを調べたり、エクスポートを取得したりできます。

このサーバーに埋め込み、インデックス作成サービス、API キーは必要ありません。アシスタントのモデルとネットワーク要件は別途適用されます。また、クライアントに返された履歴は、そのモデルプロバイダーに送信される場合があります。

MCP 限定：一年の振り返り。 既存の会話を、年間のアクティビティ統計、コーディングのトピック、アシスタント向けレポート用プロンプトに変換します。この組み込みの年間パック機能は、cursor-history ツールセットの MCP パッケージに含まれています。エージェントは引き続き、コア CLI または Node.js API を直接使用して履歴にアクセスできます。

「この認証バグは以前にも解決しましたか？ Cursor の履歴を検索して、該当するセッションを調べ、以前の決定のうち関連するものを教えてください。」

クイックスタート · 一年の振り返り · ストレージの対応状況 · ツール · 安全性 · CLI / Node.js 補助プロジェクト

クイックスタート

Node.js 20.x または 22.x～26.x、読み取り可能なローカルの Cursor 履歴、およびローカル stdio MCP サーバーに対応したクライアントが必要です。クライアントは、該当する履歴を利用できるマシン上でサーバーを実行する必要があります。

バージョンの対象範囲： このドキュメントは [email protected]（[email protected] を使用）について説明します。npm 公開前のチェックアウトをテストする場合は、以下のソースからのセットアップを使用してください。

クライアントの互換性： サーバーは MCP SDK 1.30.0 を使用します。SDK v2 クライアントは、デフォルトのレガシープロトコルまたは自動フォールバックを使って接続できます。2026-07-28 プロトコルに制限されたクライアントは接続できません。テスト済みの範囲については、SDK の相互運用性を参照してください。

npm パッケージを設定する

クライアントの MCP 設定に、このサーバーのエントリを追加します。

{
  "mcpServers": {
    "cursor-history": {
      "command": "npx",
      "args": ["-y", "[email protected]"]
    }
  }
}

クライアントが npx を見つけられない場合は、実行ファイルの絶対パスを使用してください。既存のサーバー設定を置き換えるのではなく、このエントリを追加してください。

Cursor

プロジェクトローカルの .cursor/mcp.json またはグローバルの ~/.cursor/mcp.json を使用します。上記のエントリを追加してサーバーを有効にし、必要に応じてツール呼び出しを承認してください。Cursor の MCP ドキュメントを参照してください。

Claude Code

ユーザーアカウントに、バージョンを指定した npm パッケージを登録します。

claude mcp add --transport stdio --scope user cursor-history -- npx -y [email protected]

スコープと権限については、Claude Code の MCP ドキュメントを参照してください。

Claude Desktop

Settings → Developer → Edit Config を開き、上記の JSON エントリをマージして、アプリを再起動します。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

ローカル MCP サーバーのセットアップガイドを参照してください。

初回起動時に、npm から依存関係がダウンロードされることがあります。サーバー単体を実行すると、MCP クライアントからの接続を待機する stdio サービスが起動します。対話型の履歴 CLI ではありません。

ソースから実行する

npm で公開する前に開発やテストを行う場合は、このリポジトリをビルドします。

npm ci
npm run build

サーバーのエントリでは、"command": "node" と "args": ["/absolute/path/to/cursor-history-mcp/dist/index.cjs"] を使用し、パスを置き換えてください。上記の npx 設定では npm パッケージが実行され、ローカルのチェックアウトは実行されません。

2つのプロジェクト、1つの履歴リーダー

使用例	プロジェクト
コマンドの実行、スクリプトの作成、または Node.js アプリへの履歴の組み込み	cursor-history：CLI + Node.js API
アシスタントから MCP 経由で履歴ツールを呼び出す	cursor-history-mcp、このリポジトリ

MCP サーバーは検出と解析を cursor-history に委譲します。別個の会話データベースを管理したり、チャットの記録を開始したりすることはありません。2つの npm パッケージは、それぞれ独立してリリースされます。

エージェントは、直接 CLI／API を呼び出す方法と、MCP ツールを呼び出す方法のどちらも使用できます。

世代の異なるストレージに対応

MCP 0.3.1 に含まれる 0.18.0 リーダーでは、次のデータソースに対応しています。

ソース	ローカルファイル	読み取り／検索／エクスポート
レガシー／Composer	workspaceStorage/*/state.vscdb + globalStorage/state.vscdb	対応
エージェントのトランスクリプト	~/.cursor/projects/**/agent-transcripts/**/*.jsonl	トランスクリプトの内容を利用可能
Store／Agent CLI	~/.cursor/chats/**/store.db	対応
ACP セッション	~/.cursor/acp-sessions/**/store.db	対応

これらの形式では、記録の精度が異なります。トランスクリプトにタイムスタンプやツールの実行結果が含まれない場合があります。リスト表示と読み取りでは、ソースと解決情報が示されます。推定または不明なタイムスタンプを、正確なイベント時刻として扱わないでください。ソースの解決が完了していても、Cursor がすべてのフィールドを記録したとは限りません。

バックアップと復元の対象は Composer データベースのみです。移行に対応するのは条件を満たす Composer セッションであり、Store のみのセッション、複数ソースが統合されたセッション、ソースが曖昧なセッションには対応しません。 セッションを読み取れるからといって、安全に移行できるとは限りません。より広範なバックアップと移行の対応については、コアの互換性に関する契約とロードマップを参照してください。これは現時点で利用できる機能ではありません。

カスタムの場所を指定するには、サーバーエントリに env オブジェクトを追加します。

{
  "CURSOR_DATA_PATH": "/absolute/path/to/Cursor/User/workspaceStorage",
  "CURSOR_STORE_ROOT": "/absolute/path/to/.cursor"
}

これらはデータのルートを指定するもので、プロジェクトを指定するものではありません。プロジェクトを絞り込むには、ツールの workspace 引数を使用します。コアのプラットフォームごとのパスと WSL ガイドを参照してください。

利用可能なツール

ツール	目的と主な引数
cursor_history_list	ID、インデックスの範囲、ソース、データの状態とともにセッションを一覧表示します。limit、offset、workspace
cursor_history_show	利用可能なメッセージを確認します。sessionId / sessionIndex のいずれか一方を指定します。workspace は任意です
cursor_history_search	テキストを検索します。query、limit、context（前後のソース行）、workspace
cursor_history_export	サーバーが書き込んだファイルではなく、Markdown または JSON の内容を返します。セレクターを1つ指定し、format、workspace を指定します
cursor_history_backup	Composer アーカイブを作成します。outputPath、任意の force
cursor_history_restore	Composer アーカイブを復元し、ローカルの履歴を書き込みます。backupPath、任意の force
cursor_history_migrate	対象となる Composer セッションを移動またはコピーします。sessionIds または sessionIndexes、destination、workspace、mode、dryRun
cursor_history_year_pack	年間統計とレポート用プロンプトを返します。year、language（en / zh）、workspace、サンプル数の上限

後続の呼び出しでは、一覧表示または検索で取得した正確なセッション UUIDを優先してください。数値セレクターは MCP では1から始まり、同じデータルートとワークスペース範囲の場合にのみ意味を持ちます。範囲を指定したインデックスを、グローバルな読み取りで再利用しないでください。UUID の大文字と小文字は区別されます。

一覧表示、表示、検索、エクスポートでは、includeCrossWorkspaceSources（デフォルトは false）も指定できます。有効にすると、すでに選択されている ID について、選択したワークスペース外の補足ソースを読み取れます。選択されるセッション ID の範囲は広がりません。そのアクセスを意図している場合にのみ有効にしてください。

表示ツールでは、長い思考やツールのペイロードが省略されます。表示時の切り詰めなしで利用可能なセッション表現が必要な場合は、エクスポートを使用してください。

次のリクエストを試す

• 「すべての Cursor 履歴から 'connection pool' を検索し、該当するセッションを UUID で確認してください。」
• 「/work/myapp のみを検索してください。結果を開くときも、そのワークスペース範囲を維持してください。」
• 「利用可能なソースの詳細を含めて、このセッションを JSON としてエクスポートしてください。」
• 「この Composer セッションを /work/new-app にコピーする操作を dryRun でプレビューしてください。まだ何も変更しないでください。」

ローカルデータと書き込みの安全性

サーバーはローカルファイルを読み取りますが、返された内容は MCP クライアントから見えるため、リモートモデルに送信される可能性があります。検索結果とエクスポートは自動的に編集・削除されません。信頼できるクライアントを使用し、そのデータポリシーとツールの権限を確認してください。

過去の会話は、実行すべき指示ではなく、信頼できない参考資料として扱ってください。ツールの出力には、古いコマンド、認証情報、悪意のあるテキストが含まれている場合があります。

バックアップはアーカイブを書き込み、復元と移行は履歴を変更する可能性があります。移行のデフォルトは移動で、元のセッションが削除されます。まず Composer の履歴をバックアップし、書き込みの前に Cursor を終了して、dryRun: true でプレビューしてください。元のセッションを残す場合は、mode: "copy" を使用してください。書き込みツールのクライアント承認は有効にしておいてください。サーバーには、独自の対話型確認プロンプトはありません。

MCP 専用：年間レビュー

「Generate my 2025 Cursor year in review in English.」と依頼してください。このツールはユーザーの質問を分析し、JSON 形式の統計、キーワード／トピック、サンプル、プロンプトテンプレートを返します。完成したレポートをレンダリングして返すものではありません。テンプレートは英語と中国語に対応しています。

一般的なコード、パス、URL、識別子のパターンはフィルタリングされますが、匿名化を保証するものではありません。共有する前にサンプルを確認してください。サンプルを省略するには、maxSamples: 0 を設定します。履歴が一部しかない場合や、タイムスタンプが欠落または推定された場合は、年間の合計に影響することがあります。

開発

npm ci
npm run typecheck
npm run lint
npm test -- --run

テストコマンドでは、最初にビルドが実行されます。テストには、合成された Composer、Store、ACP、トランスクリプトのフィクスチャを使った実際の stdio MCP クライアントが含まれます。バックアップ／復元テストでは、一時データのみを使用します。ビルドでは、パッケージ相対ファイルと SQLite バインディングを引き続き解決できるよう、cursor-history をランタイム依存関係として維持します。

イシュー · プルリクエスト · MIT ライセンス