# MCP Git Manager — Git Operations for AI Agents

> An MCP server that gives AI agents git repository access: status, log, diff, branch, commit, push, pull, tag, stash, remotes — 24 tools, zero dependencies, pure Python stdlib (subprocess).

## Features

- **24 MCP Tools**: git_status, git_log, git_diff, git_branch_list, git_branch_create, git_checkout, git_branch_delete, git_add, git_commit, git_push, git_pull, git_fetch, git_tag_create, git_tag_list, git_tag_delete, git_stash, git_stash_list, git_stash_pop, git_remote_list, git_remote_add, git_remote_remove, git_show, git_current_branch, git_is_repo
- **Zero dependencies** — pure Python stdlib (subprocess, os, re, json)
- **Real git binary** — wraps the actual git executable via subprocess
- **Full branch lifecycle** — create, checkout, delete, list
- **Complete tag support** — create, list, delete (annotated)
- **Stash management** — stash, list, pop
- **Remote management** — add, remove, list remotes with URLs
- **STDIO JSON-RPC mode** — drop-in for Claude Desktop, Hermes

## Tests

```bash
python -m pytest tests/ -v  # 36 tests, all passing (real temp git repos)
```

## License

MIT — aaameobius-crypto

Freelance portfolio: [https://ameobius-space.github.io/kwork-portfolio/](https://ameobius-space.github.io/kwork-portfolio/)