光标历史MCP
MCP服务器，用于浏览、搜索、导出和备份您的Cursor AI聊天历史记录。
将您的Cursor AI聊天记录直接带入Claude。通过自然语言搜索过去的对话、导出会话、创建备份和生成年度回顾报告。建立在 模型上下文协议 实现无缝的AI助手集成。
免费、开源和麻省理工学院许可。由社区建造，为社区服务。
为什么是这个项目？
还有其他Cursor历史记录工具（比如基于Python的 光标历史MCP).以下是它的不同之处：
| 功能 | 光标历史mcp（此项目） | 其他解决方案 |
|---|---|---|
| 📦 设置 | ✅ npx cursor-history-mcp -零安装 | ❌ Docker、Python、依赖关系 |
| ⚡ 速度 | ✅ 即时直接读取SQLite | ❌ 慢速-需要LLM矢量化 |
| 🔍 搜索 | ✅ Grep风格文本匹配-精确稳定 | ❌ 矢量检索-不可预测的结果 |
| 🤖 LLM必修 | ✅ 否-脱机工作 | ❌ 是-需要Ollama/嵌入 |
| 🛠️ 语言 | ✅ TypeScript（类型安全） | ⚠️ python |
| 💾 备份/恢复 | ✅ 内置 | ❌ 不可用 |
| 🚚 迁移 | ✅ 在工作区之间移动会话 | ❌ 不可用 |
| 📋 依赖项 | ✅ 最小（仅Node.js） | ❌ Docker、LanceDB、Ollama、FastAPI |
关键优势
- 快速燃烧：无嵌入或矢量化步骤。直接从Cursor的原生SQLite数据库读取，因此结果是即时的。
- Grep风格搜索：使用直接文本匹配而不是矢量检索。对于大多数用例来说，它更轻量级、更可预测、更稳定——没有幻觉结果，没有嵌入漂移，每次都精确匹配。
- 零配置：跑步
npx-没有Docker容器，没有Python环境，没有API密钥，没有LLM设置。 - 离线工作：一切都在本地运行，没有任何外部服务或人工智能模型。
- 数据可移植性：完整的备份、还原和跨工作区迁移功能，确保您的聊天历史记录安全便携。
- 轻量级：约50KB的包与带矢量数据库的多GB Docker映像。
安装
无需安装！直接通过npx运行：
npx cursor-history-mcp配置
光标
克劳德代码
添加到您的Claude Code MCP设置中：
{
"mcpServers": {
"cursor-history": {
"command": "npx",
"args": ["-y", "cursor-history-mcp"]
}
}
}克劳德桌面版
添加到您的Claude Desktop配置(~/.claude/claude_desktop_config.json):
{
"mcpServers": {
"cursor-history": {
"command": "npx",
"args": ["-y", "cursor-history-mcp"]
}
}
}可用工具
| 工具 | 说明 |
|---|---|
cursor_history_list | 列出带有元数据的聊天会话 |
cursor_history_show | 查看完整对话内容 |
cursor_history_search | 在所有会话中搜索 |
cursor_history_export | 将会话导出为Markdown或JSON |
cursor_history_backup | 创建所有历史记录的备份 |
cursor_history_restore | 从备份还原（破坏性） |
cursor_history_migrate | 在工作区之间移动/复制会话（破坏性） |
cursor_history_year_pack | 使用统计数据、主题和提示模板生成年度回顾数据包 |
🎆 年度回顾
根据您的Cursor AI聊天历史生成个性化的年度报告——发现您的编码模式、最喜欢的主题和开发历程。
所得
| 📊 聊天统计 | 问题总数、活跃月份、月度活动 |
| 🏷️ 主题发现 | 自动检测编码主题和兴趣 |
| 📈 趋势跟踪 | 你的注意力在一年中是如何转移的 |
| 🔑 关键词 | 你最常用的术语和短语 |
| 🔒 隐私安全 | 敏感数据自动屏蔽 |
| 📝 LLM 提示 | 即用型提示，打造精美报告 |
试试看
- “生成我的2025光标年回顾”
- “为~/myapp创建一个年包”
- “用英语生成我的2025年回顾”
用法示例
配置后，询问您的AI助手：
- “列出我的Cursor聊天会话”
- “显示会话#1”
- “在我的游标历史记录中搜索“身份验证””
- “将会话#1导出为markdown”
- “备份我的Cursor聊天记录”
需求
- Node.js 20+
- 已安装带有现有聊天历史记录的Cursor IDE
贡献
欢迎投稿！无论是错误报告、功能请求、文档改进还是代码贡献，我们都很感激所有的PR和问题。
许可证
麻省理工学院
