Local History

Local History MCP 服务

通过 Model Context Protocol 访问 Cursor/VS Code Local History，实现 AI 驱动的数据恢复

概述

此 MCP 服务连接了 AI 助手与编辑器 Local History，让用户能够恢复数据并增强上下文感知能力。与撤销/重做不同，Local History 会在保存时捕获文件快照，保留原本可能丢失的工作成果。

问题：目前的 AI 助手（Claude、Cursor AI、GitHub Copilot）虽然具备强大的诊断能力，却无法访问 Local History 数据。

解决方案：简单的 MCP 服务，可直接访问 Cursor/VS Code Local History，供个人使用。

安装

选项 1：包管理器（推荐）

使用你偏好的包管理器安装：

# npm
npx local-history-mcp

# pnpm
pnpm dlx local-history-mcp

# yarn
yarn global add local-history-mcp

# bun
bunx local-history-mcp

选项 2：从源代码安装

git clone https://github.com/xxczaki/local-history-mcp.git && cd local-history-mcp
pnpm install
pnpm build
pnpm start

MCP 工具

工具	描述
list_history_files	列出所有具有 Local History 的文件
get_file_history	查看文件的完整历史记录
get_history_entry	获取特定历史记录条目的内容
restore_from_history	将文件恢复到之前的状态（带备份）
search_history_content	搜索所有历史记录条目
get_history_stats	查看统计概览

配置

Cursor

你可以使用一键安装按钮在 Cursor 中安装此 MCP 服务：

也可以按照 Cursor 官方 MCP 文档手动配置。

Claude Code 和 Claude Desktop

对于 Claude Code（CLI），请直接安装：

claude mcp add local-history -- npx -y local-history-mcp

对于 Claude Desktop，请参阅 MCP 官方文档。

VS Code

请参阅官方文档。

开发

# Development mode
pnpm dev

# Run tests
pnpm test

# Linting and formatting
pnpm lint

# Launch MCP Inspector
pnpm inspector

AI 声明

此项目包含在人工监督和校对下由大语言模型（LLM）生成的代码。

许可证

MIT