convez.ai
MCP ServerProdutividadeIntermediário
xxczaki

Local History MCP Server

xxczaki/local-history-mcp

Acesse histórico de arquivos do VS Code/Cursor via MCP para IA

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor 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-mcp

1 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

Estrelas
16
Forks
5
Acompanhando
0
Saúde
42%
Último commit
há 2 dias
Versão
v1.1.2
Issues abertas
13
Contribuidores
3

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

CI Release MCP

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

ToolDescription
list_history_filesList all files with Local History
get_file_historyView complete history for a file
get_history_entryGet specific history entry content
restore_from_historyRestore file to previous state (with backup)
search_history_contentSearch across all history entries
get_history_statsOverview statistics

Configuration

Cursor

You can install this MCP server in Cursor using the one-click install button:

Install MCP Server

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

Ver o original no GitHub

Bom para

Relacionados