cyanheads/git-mcp-server

A Git MCP server for AI agents. STDIO & Streamable HTTP.
28 Tools · 1 Resource · 1 Prompt
## Tools
28 git operations organized into seven categories:
| Category | Tools | Description |
| Repository Management | gitinit, gitclone, gitstatus, gitclean | Initialize repos, clone from remotes, check status, clean untracked files |
| Staging & Commits | gitadd, gitcommit, gitdiff | Stage changes, create commits, compare changes |
| History & Inspection | gitlog, gitshow, gitblame, gitreflog | View commit history, inspect objects, trace authorship, view ref logs |
| Analysis | gitchangeloganalyze | Gather git context and instructions for LLM-driven changelog analysis |
| Branching & Merging | gitbranch, gitcheckout, gitmerge, gitrebase, gitcherrypick | Manage branches, switch contexts, integrate changes, apply specific commits |
| Remote Operations | gitremote, gitfetch, gitpull, gitpush | Configure remotes, fetch updates, synchronize repositories, publish changes |
| Advanced Workflows | gittag, gitstash, gitreset, gitworktree, gitsetworkingdir, gitclearworkingdir, gitwrapupinstructions | Tag releases (list/create/delete/verify), stash changes, reset state, manage worktrees, set/clear session directory |
## Resources
| Resource | URI | Description |
| Git Working Directory | git://working-directory | The current session working directory, set via gitsetworkingdir. |
## Prompts
| Prompt | Description | Parameters |
| Git Wrap-up | Workflow protocol for completing git sessions: review, document, commit, and tag changes. | changelogPath, createTag. |
## Getting started
### Runtime
Works with both Bun and Node.js. Runtime is auto-detected.
| Runtime | Command | Minimum Version |
| Node.js | npx @cyanheads/git-mcp-server@latest | >= 20.0.0 |
| Bun | bunx @cyanheads/git-mcp-server@latest | >= 1.2.0 |
### MCP client configuration
Add the following to your MCP client config (e.g., clinemcpsettings.json). Update the environment variables to match your setup — especially the git identity fields.
json
"mcpServers": {
"git-mcp-server": {
"type": "stdio",
"command": "npx",
"args": ["@cyanheads/git-mcp-server@latest"],
"env": {
"MCPTRANSPORTTYPE": "stdio",
"MCPLOGLEVEL": "info",
"GITBASEDIR": "~/Developer/",
"LOGSDIR": "~/Developer/logs/git-mcp-server/",
"GITUSERNAME": "cyanheads",
"GITEMAIL": "casey@caseyjhand.com",
"GITSIGNCOMMITS": "true"
Bun users: replace "command": "npx" with "command": "bunx".
For Streamable HTTP, set MCPTRANSPORTTYPE=http and MCPHTTPPORT=3015.
## Features
Built on mcp-ts-template.
| Feature | Details |
| Declarative tools | Define capabilities in single, self-contained files. The framework handles registration, validation, and execution. |
| Error handling | Unified McpError system for consistent, structured error responses. |
| Authentication | Supports none, jwt, and oauth modes. |
| Pluggable storage | Swap backends (in-memory, filesystem, Supabase, Cloudflare KV/R2) without changing business logic. |
| Observability | Structured logging (Pino) and optional auto-instrumented OpenTelemetry for traces and metrics. |
| Dependency injection | Built with tsyringe for decoupled, testable architecture. |
| Cross-runtime | Auto-detects Bun or Node.js and uses the appropriate process spawning method. |