Cursor History MCP

🚀 Cursor History MCP

Cursor AIのチャット履歴を閲覧、検索、エクスポート、バックアップするためのMCPサーバーです。自然言語を通じて、過去の会話を検索し、セッションをエクスポートし、バックアップを作成し、通年レポートを生成することができます。Model Context Protocolに基づいて構築されており、AIアシスタントとのシームレスな統合が可能です。

🇨🇳 中国語ドキュメント | 🇫🇷 フランス語 | 🇪🇸 スペイン語

🚀 クイックスタート

このプロジェクトは、Cursor AIのチャット履歴を管理するためのMCPサーバーです。チャット履歴の閲覧、検索、エクスポート、バックアップなどの機能を提供します。

✨ 主な機能

なぜこのプロジェクトなのか？

他にもCursorの履歴管理ツールがありますが、このプロジェクトは以下の点で異なります。

主な利点

• 超高速: 埋め込みやベクトル化のステップが不要で、CursorのネイティブSQLiteデータベースから直接読み取るため、結果が即座に得られます。
• Grepスタイルの検索: ベクトル検索ではなく、直接のテキストマッチングを使用します。ほとんどのユースケースでより軽量で予測可能で安定しており、幻覚的な結果や埋め込みのドリフトがなく、常に正確なマッチが得られます。
• ゼロ設定: npxで実行でき、Dockerコンテナ、Python環境、APIキー、LLMのセットアップが不要です。
• オフラインで動作: 外部サービスやAIモデルを必要とせず、すべてローカルで実行されます。
• データの可搬性: 完全なバックアップ、復元、およびワークスペース間の移行機能を備えており、チャット履歴を安全かつ可搬に保つことができます。
• 軽量: ~50KBのパッケージで、ベクトルデータベースを含む数GBのDockerイメージと比較して非常に軽量です。

📦 インストール

インストールは不要です！npxを介して直接実行できます。

npx cursor-history-mcp

📚 詳細ドキュメント

設定

Cursor

Claude Code

Claude CodeのMCP設定に以下を追加します。

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

Claude Desktop

Claude Desktopの設定 (~/.claude/claude_desktop_config.json) に以下を追加します。

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

利用可能なツール

🎆 通年レポート

Cursor AIのチャット履歴からパーソナライズされた通年レポートを生成します。コーディングパターン、お気に入りのトピック、開発の旅を発見できます。

得られるもの

試してみる

• "2025年のCursor通年レポートを生成して"
• "~/myappの通年パッケージを作成して"
• "2025年の通年レポートを英語で生成して"

💻 使用例

設定後、AIアシスタントに以下のように尋ねます。

• "Cursorのチャットセッションを一覧表示して"
• "セッション#1を表示して"
• "Cursorの履歴から「authentication」を検索して"
• "セッション#1をMarkdown形式でエクスポートして"
• "Cursorのチャット履歴をバックアップして"

🔧 技術詳細

要件

• Node.js 20以上
• 既存のチャット履歴を持つCursor IDEがインストールされていること

コントリビューション

バグレポート、機能リクエスト、ドキュメントの改善、コードの貢献など、すべてのPRとイシューを歓迎します。

• イシューを開く
• プルリクエストを送信する

📄 ライセンス

MIT