项目简介

"本地历史MCP服务器" 是一款强大的工具，它通过Model Context Protocol (MCP) 将AI助手与您的Cursor或VS Code编辑器的本地文件历史记录连接起来。这意味着您的AI助手现在可以访问文件保存时的历史快照，帮助您进行数据恢复、代码回溯，甚至在AI生成内容时提供更丰富的上下文信息，远超传统的撤销/重做功能。

主要功能点

列出历史文件：查看所有具有本地历史记录的文件。
获取文件完整历史：查看指定文件的所有历史版本及其详细信息。
获取特定历史条目：根据索引获取文件某个特定历史版本的内容。
从历史恢复文件：将文件恢复到历史上的某个版本，并可选择是否创建当前文件的备份。
搜索历史内容：在所有历史记录中搜索特定文本内容。
获取历史统计：查看本地历史的总文件数、总条目数等概览信息。

安装步骤

通过包管理器安装 (推荐)：打开终端，运行以下任一命令，即可安装并运行该MCP服务器：

# npm
npx local-history-mcp

# pnpm
pnpm dlx local-history-mcp

# yarn (全局安装)
yarn global add local-history-mcp

# bun
bunx local-history-mcp

从源代码安装：如果您想从源代码运行，请执行以下步骤：

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

服务器配置

要让您的MCP客户端（如Cursor、Claude Code/Desktop、VS Code）连接到此服务器，您需要配置服务器的启动命令。以下是适用于大多数MCP客户端的通用配置信息，您可以将其添加到客户端的MCP服务器配置中：

{
  "name": "local-history", // 服务器在客户端中显示的名称
  "command": "npx",        // 启动服务器的命令行工具
  "args": ["-y", "local-history-mcp"] // 传递给命令行工具的参数，用于启动本地历史MCP服务器
}

Cursor 配置: 点击以下链接进行一键安装：或参考 Cursor 官方 MCP 文档手动配置。

Claude Code (CLI) 配置: 直接在命令行中添加：

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

Claude Desktop / VS Code 配置: 请参考各自的官方 MCP 文档和 VS Code 官方文档进行手动配置。

基本使用方法

一旦服务器配置并启动，您的AI助手就可以通过调用其提供的工具来访问本地历史。例如，您可以在AI助手中提问：“列出我最近修改过的所有文件。”或者“显示文件 '/path/to/my/file.txt' 的历史记录。”，AI助手将自动调用相应的MCP工具来获取信息并为您展示。您还可以指示AI助手搜索历史内容或将文件恢复到某个特定版本。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息