Cursor History MCP

🚀 Cursor History MCP

Cursor History MCP 是一個基於 Model Context Protocol 的 MCP 服務器，可用於瀏覽、搜索、導出和備份你的 Cursor AI 聊天曆史記錄。你可以直接將聊天曆史導入 Claude，通過自然語言搜索過往對話、導出會話、創建備份以及生成年度回顧報告。該項目免費開源，採用 MIT 許可協議，由社區為社區打造。

🇨🇳 中文文檔 | 🇫🇷 Français | 🇪🇸 Español

🚀 快速開始

Cursor History MCP 旨在為你提供便捷的 Cursor AI 聊天曆史管理體驗。你可以通過自然語言與 AI 助手交互，實現對聊天曆史的各種操作。

✨ 主要特性

與其他工具的對比

市面上存在其他 Cursor 歷史記錄工具（如基於 Python 的 Cursor-history-MCP），本項目具有以下不同之處：

關鍵優勢

• 極速響應：無需嵌入或向量化步驟，直接從 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 聊天曆史記錄中生成個性化的年度報告，發現你的編碼模式、感興趣的主題和開發歷程。

報告內容

嘗試使用

• "Generate my 2025 Cursor year in review"（生成我 2025 年的 Cursor 年度回顧）
• "Create a year pack for ~/myapp"（為 ~/myapp 創建年度數據包）
• "Generate my 2025 year in review in English"（以英語生成我 2025 年的年度回顧）

💻 使用示例

配置完成後，你可以向 AI 助手提出以下問題：

• "List my Cursor chat sessions"（列出我的 Cursor 聊天會話）
• "Show me session #1"（顯示會話 #1）
• "Search my Cursor history for 'authentication'"（在我的 Cursor 歷史記錄中搜索 'authentication'）
• "Export session #1 as markdown"（將會話 #1 導出為 Markdown 格式）
• "Backup my Cursor chat history"（備份我的 Cursor 聊天曆史記錄）

📋 要求

• Node.js 20+
• 已安裝 Cursor IDE 並存在聊天曆史記錄

🤝 貢獻

歡迎貢獻代碼！無論是 bug 報告、功能請求、文檔改進還是代碼貢獻，所有的 PR 和問題都將受到歡迎。

• 提交問題
• 提交拉取請求

📄 許可證

本項目採用 MIT 許可證。