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 许可证。