# MCP Git Analysis Server

An MCP (Model Context Protocol) server that analyzes local git repositories and provides insights about commits, contributors, and file changes.

## Features

### Tools

1. **analyze_commits** - Get commit statistics with optional filters
   - Filter by count, author, or date range
   - Returns detailed commit information including changes

2. **find_hot_spots** - Find most frequently changed files
   - Shows files with most commits
   - Includes number of unique authors per file

3. **get_contributors** - List all contributors with statistics
   - Shows commit counts, insertions, deletions
   - Includes first and last commit dates

### Resources

1. **git://recent-activity** - Last 10 commits as structured data
2. **git://file-history/{filepath}** - Change history for a specific file

## Installation

```bash
# Install dependencies
pip install -r requirements.txt
```

## Usage

### With MCP Inspector

```bash
# Run the server with MCP Inspector
mcp dev server.py
```

### As MCP Server

Configure in your MCP client settings:

```json
{
  "mcpServers": {
    "git-analysis": {
      "command": "python3",
      "args": ["/path/to/server.py"]
    }
  }
}
```

## Example Tool Calls

### Analyze Recent Commits
```json
{
  "name": "analyze_commits",
  "arguments": {
    "count": 5
  }
}
```

### Find Hot Spots
```json
{
  "name": "find_hot_spots",
  "arguments": {
    "limit": 10
  }
}
```

### Get Contributors
```json
{
  "name": "get_contributors",
  "arguments": {}
}
```

## Example Resource Access

- `git://recent-activity` - Get recent activity
- `git://file-history/src/main.py` - Get history for specific file

## Requirements

- Python 3.8+
- Git repository
- GitPython library
- MCP SDK

## Testing

Test with MCP Inspector:
```bash
npx @modelcontextprotocol/inspector python3 server.py
```