git-reflog-archaeologist-mcp
Analyzes Git reflog and object metadata to provide recovery signals, helping determine if recent history or unreachable commits may be recoverable after accidental resets, branch deletions, or abandoned experiments.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@git-reflog-archaeologist-mcp Analyze my reflog for recoverable commits after a hard reset"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
git-reflog-archaeologist-mcp
Git Reflog Archaeologist is a local MCP for the moment after an accidental reset, deleted branch, or abandoned experiment. It looks at Git metadata that can help answer whether recovery may still be possible.
Tools
reflog_signals: aggregate reflog count, age buckets, and loose or packed object countsrecovery_signals: aggregate unreachable object counts by typestash_signals: aggregate stash count and age buckets
The outputs include coarse recovery hints such as recent-history-may-be-recoverable or unreachable-commits-found. They do not return commit hashes, subjects, ref names, file paths, remote names, author data, or file contents.
Related MCP server: Repo Therapist
Safety
Local Git commands only. No network access is used.
The selected repository must stay inside
GIT_ARCHAEOLOGY_ROOT.Git output is line and count bounded.
The server never runs mutating commands such as reset, reflog expire, prune, or garbage collection.
This is a recovery signal tool, not a guarantee that an object can be restored.
Run
npm install
npm run build
node dist/index.jsThe server uses stdio and works with Claude Desktop, Cursor, VS Code, MCP Inspector, and compatible CLI harnesses.
Available Tools
3 toolsrecovery_signalsA
Count unreachable Git object types and recovery hints without returning object IDs, messages, paths, or contents.
Inputs: cwd.
reflog_signalsA
Summarize local reflog activity by count and age bucket without returning ref names, hashes, subjects, paths, or remotes.
Inputs: cwd.
stash_signalsA
Summarize local stash age buckets and count without returning stash messages, refs, hashes, or paths.
Inputs: cwd.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a distinct Git data source: reflog, unreachable objects, and stash. The descriptions clearly separate their inputs and outputs, leaving no ambiguity about which tool to choose for a given task.
All tool names follow the exact same pattern of '<domain>_signals', creating a predictable and uniform naming scheme. This consistency makes it easy to infer the purpose of any tool in the set.
With only three tools, the server is tightly scoped to its 'archaeologist' purpose. Each tool covers a different aspect of Git history recovery, and none feel redundant or extraneous.
The server covers the main recovery-related signals: reflog activity, unreachable objects, and stash state. While other signals like branch or tag history could be added, the core recovery workflow is well represented and no critical gaps are apparent.
Maintenance
Related MCP Connectors
A MCP server built for developers enabling Git based project management with project and personal…
Audit your MCP servers for poisoned tools and leaked secrets, and check AI-generated code for flaws.
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
Related MCP Servers
- AlicenseBqualityDmaintenanceA specialized MCP server for in-depth analysis of git repositories, offering tools for branch overview, time period analysis, file changes, and merge recommendations.47Apache 2.0
- AlicenseAqualityDmaintenanceAn MCP server that transforms repositories into queryable knowledge by combining static code analysis with git history tracking. It allows users to investigate codebase structure, identify fragile files based on churn, and receive risk assessments through natural language queries.7MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that gives AI assistants deep understanding of your local Git repositories, providing instant repo overviews, change summaries, blame analysis, changelogs, branch health checks, and history search.71 npmMIT
- AlicenseNot gradedqualityCmaintenanceMCP server for fast, bounded, read-only Git evidence, enabling AI agents to query commit history, diffs, status, and snapshots by parsing repository storage directly.345 npmMIT