Metadata-Version: 2.4
Name: git-telemetry-mcp
Version: 0.1.0
Summary: MCP server exposing git reflog, working directory, and bash history as temporal context tools
Author: Git Telemetry MCP Contributors
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: git,mcp,model-context-protocol,telemetry
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.13
Requires-Dist: sse-starlette>=2.2
Requires-Dist: starlette>=0.46
Requires-Dist: uvicorn[standard]>=0.34
Description-Content-Type: text/markdown

# Git Telemetry MCP

An MCP server (target spec `2026-07-28`) providing a **Development Time Machine**. Analyzes git reflogs, commit history, working directory deltas, and shell history to give AI assistants temporal context about developer activity.

## Quick Start

```bash
# Install dependencies
uv sync

# Run the MCP server (HTTP JSON-RPC on http://127.0.0.1:8787/mcp, SSE on /sse)
uv run git-telemetry-mcp

# Run tests
uv run pytest
```

## MCP Client Configuration

Add to your MCP client config (e.g. Claude Desktop, Cursor, OpenCode):

```json
{
  "mcpServers": {
    "git-telemetry": {
      "url": "http://127.0.0.1:8787/mcp"
    }
  }
}
```

## Key Features & Architecture

- **16 MCP Tools:** Context packs, reflog timelines, dirty diff summaries, shell correlation, dry-run merge checks, stale branch detection, and smart commit generation.
- **Privacy First:** Built-in serializer gate redacts PII, private keys, authorization tokens, API keys, and database credentials before payload return.
- **Contract Compliant:** Every tool emits a `telemetry_payload` envelope (`timezone_offset`, `repo_checksum`, `confidence_score`, `data`) validated against draft-07 `outputSchema` and annotated with `readOnlyHint`, `destructiveHint`, and `idempotentHint`.
- **Safe Destructive Operations:** Two-round-trip `input_required` confirmation flow for `safe_git_reset` and `safe_git_checkout`.

For complete documentation, tool reference, argument schemas, sample outputs, and protocol details, see [HANDBOOK.md](HANDBOOK.md).
