https://github.com/xxczaki/local-history-mcp
MCP server for accessing VS Code/Cursor's Local History
https://github.com/xxczaki/local-history-mcp
ai artificial-intelligence cursor data-recovery llm local-history mcp mcp-server model-context-protocol visual-studio-code vs-code
Last synced: 26 days ago
JSON representation
MCP server for accessing VS Code/Cursor's Local History
- Host: GitHub
- URL: https://github.com/xxczaki/local-history-mcp
- Owner: xxczaki
- License: mit
- Created: 2025-08-15T16:18:38.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-10-01T21:55:46.000Z (about 1 month ago)
- Last Synced: 2025-10-01T23:33:01.560Z (about 1 month ago)
- Topics: ai, artificial-intelligence, cursor, data-recovery, llm, local-history, mcp, mcp-server, model-context-protocol, visual-studio-code, vs-code
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/local-history-mcp
- Size: 188 KB
- Stars: 9
- Watchers: 0
- Forks: 3
- Open Issues: 4
-
Metadata Files:
- Readme: readme.md
- Changelog: CHANGELOG.md
- License: license
Awesome Lists containing this project
- awesome-mcp-servers - **Local History** - MCP server for accessing VS Code/Cursor's Local History. `local` `http` `git` `github` (📦 Other)
- awesome-mcp-servers - Local History MCP
README
# Local History MCP Server
> Access Cursor/VS Code Local History through the Model Context Protocol for AI-powered data recovery
[](https://github.com/xxczaki/local-history-mcp/actions/workflows/ci.yml) [](https://github.com/xxczaki/local-history-mcp/actions/workflows/publish.yml) [](https://modelcontextprotocol.io)
## 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:
```bash
# 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
```bash
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**:
[](https://cursor.com/en/install-mcp?name=local-history&config=eyJjb21tYW5kIjogIm5weCIsICJhcmdzIjogWyIteSIsICJsb2NhbC1oaXN0b3J5LW1jcCJdfQo%3D)
Or manually configure by following the [official Cursor MCP documentation](https://docs.cursor.com/en/context/mcp).
### Claude Code & Claude Desktop
For **Claude Code** (CLI), install directly:
```bash
claude mcp add local-history -- npx -y local-history-mcp
```
For **Claude Desktop**, see the [official MCP documentation](https://docs.anthropic.com/en/docs/claude-code/mcp).
### VS Code
See the [official documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server).
## Development
```bash
# 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