Local History MCP Server
xxczaki/local-history-mcp
Acesse histórico de arquivos do VS Code/Cursor via MCP para IA
Ver no GitHubServidor MCP que expõe o histórico local do VS Code/Cursor para assistentes de IA, permitindo recuperação de dados e acesso a snapshots de arquivos salvos. Funciona como ponte entre Claude, Cursor AI e o histórico completo de versões mantido pelos editores, sem depender de undo/redo.
Instalação
npx convez-ai xxczaki/local-history-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Recuperar conteúdo perdido de arquivos editados
- Fornecer contexto completo de evolução de código ao Claude/Cursor AI
- Pesquisar e rastrear mudanças em histórico de projetos
- Restaurar arquivos para estados anteriores com backup automático
Veredito

Ferramenta técnica sólida que resolve um gap real: dar a assistentes de IA acesso ao histórico local que editores mantêm nativamente. Bem documentada, com instalação via package managers e suporte direto para Cursor, Claude Desktop e VS Code. Ideal para desenvolvedores que querem aproveitar recuperação de dados e contexto histórico em fluxos com IA.
README
A tradução para o português deste README ainda está na fila.
Local History MCP Server
Access Cursor/VS Code Local History through the Model Context Protocol for AI-powered data recovery
Overview
This MCP server bridges the gap between AI assistants and editor Local History, enabling data recovery and enhanced context awareness. Unlike undo/redo, Local History captures file snapshots at save points, preserving work that would otherwise be lost.
Problem: Current AI assistants (Claude, Cursor AI, GitHub Copilot) cannot access Local History data despite having extensive diagnostic capabilities.
Solution: Simple MCP server providing direct access to Cursor/VS Code Local History for personal use.
Installation
Option 1: Package Manager (Recommended)
Install using your preferred package manager:
# npm
npx local-history-mcp
# pnpm
pnpm dlx local-history-mcp
# yarn
yarn global add local-history-mcp
# bun
bunx local-history-mcp
Option 2: From Source
git clone https://github.com/xxczaki/local-history-mcp.git && cd local-history-mcp
pnpm install
pnpm build
pnpm start
MCP Tools
| Tool | Description |
|---|---|
list_history_files | List all files with Local History |
get_file_history | View complete history for a file |
get_history_entry | Get specific history entry content |
restore_from_history | Restore file to previous state (with backup) |
search_history_content | Search across all history entries |
get_history_stats | Overview statistics |
Configuration
Cursor
You can install this MCP server in Cursor using the one-click install button:
Or manually configure by following the official Cursor MCP documentation.
Claude Code & Claude Desktop
For Claude Code (CLI), install directly:
claude mcp add local-history -- npx -y local-history-mcp
For Claude Desktop, see the official MCP documentation.
VS Code
See the official documentation.
Development
# Development mode
pnpm dev
# Run tests
pnpm test
# Linting and formatting
pnpm lint
# Launch MCP Inspector
pnpm inspector
AI disclosure
This project contains code generated by Large Language Models (LLMs), under human supervision and proofreading.
License
MIT