Skip to main content
Glama
git-reflog-archaeologist-mcp

git-reflog-archaeologist-mcp

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 counts

  • recovery_signals: aggregate unreachable object counts by type

  • stash_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.js

The server uses stdio and works with Claude Desktop, Cursor, VS Code, MCP Inspector, and compatible CLI harnesses.

Available Tools

3 tools
recovery_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

    A4.3/5.0

    Scored across 3 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A specialized MCP server for in-depth analysis of git repositories, offering tools for branch overview, time period analysis, file changes, and merge recommendations.
      4
      7
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      An 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.
      7
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An 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 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP 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 npm
      MIT