git-mcp-server

Overview

The git-mcp-server by cyanheads enables AI agents to interact with Git repositories through the Model Context Protocol. It offers a wide range of Git operations organized into seven categories: repository management, staging and commits, history and inspection, analysis, branching and merging, remote operations, and advanced workflows. The server supports both STDIO and HTTP transport modes with authentication options including JWT and OAuth. It's built with TypeScript using modern software architecture principles including dependency injection, pluggable storage backends, and comprehensive error handling.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• git_init

  Initialize a new Git repository

  Try:Create a new Git repository in this directoryTry:Initialize git repo for my project
• git_clone

  Clone a repository from a remote URL

  Try:Clone https://github.com/user/repo.gitTry:Get a copy of the main repository
• git_status

  Show working tree status

  Try:Show current git statusTry:Check what changes are staged
• git_add

  Add file contents to the staging area

  Try:Stage all changes for commitTry:Add specific file to staging area
• git_commit

  Record changes to the repository

  Try:Create a commit with message 'Fix bug'Try:Commit staged changes with description
• git_log

  Show commit history

  Try:Show last 10 commitsTry:Get commit history for feature branch
• git_branch

  List, create, or delete branches

  Try:List all branchesTry:Create a new branch for feature work
• git_checkout

  Switch branches or restore working tree files

  Try:Switch to main branchTry:Checkout new branch from feature
• git_merge

  Join two or more development histories together

  Try:Merge feature branch into mainTry:Integrate changes from develop
• git_push

  Update remote refs with local commits

  Try:Push commits to remoteTry:Push current branch to origin
• git_pull

  Fetch and integrate remote changes

  Try:Pull latest changes from remoteTry:Update local branch with remote
• git_diff

  Show changes between commits, commit and working tree, etc

  Try:Show diff for staged changesTry:See what changed since last commit

Comparable tools

Installation

# Node.js
npx @cyanheads/git-mcp-server@latest

# Bun
bunx @cyanheads/git-mcp-server@latest

{
  "mcpServers": {
    "git-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["@cyanheads/git-mcp-server@latest"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "MCP_LOG_LEVEL": "info",
        "GIT_BASE_DIR": "~/Developer/",
        "LOGS_DIR": "~/Developer/logs/git-mcp-server/",
        "GIT_USERNAME": "your-username",
        "GIT_EMAIL": "your-email",
        "GIT_SIGN_COMMITS": "true"
      }
    }
  }
}

FAQ

Does this server support commit signing?

Yes, GPG/SSH signing is enabled by default for commits, merges, rebases, cherry-picks, and tags. It falls back to unsigned on failure while providing signed/signingWarning fields in responses.

What authentication methods are supported?

The server supports three authentication modes: none (default), JWT, and OAuth. JWT and OAuth can be configured for authenticated deployments.

Compare git-mcp-server with