mcp-git

# MCP Git Server An MCP (Model Context Protocol) server that provides comprehensive Git operations as tools for AI assistants and applications. This server enables AI systems to interact with Git repositories through a structured, validated interface. ## Tools The server provides the following Git operations: ### Repository Management 1. **`init`** - Initialize new Git repository 2. **`status`** - Get repository status with detailed file information ### File Operations 3. **`add`** - Stage files for commit 4. **`reset`** - Reset repository state (soft, mixed, hard) ### Commit Operations 5. **`commit`** - Create commits with comprehensive options 6. **`log`** - View commit history with filtering and formatting options 7. **`show`** - Display commit details and changes ### Branch Operations 8. **`create-branch`** - Create new branches from any starting point 9. **`checkout`** - Switch branches/commits with advanced options ### Comparison Operations 10. **`diff`** - Show differences between commits, branches, or files > [!NOTE] Server intentionally lacks push operations to avoid security risks. ## Tool Details ### git_status Shows the working tree status with comprehensive formatting options. **Inputs:** - `repoPath` (string): Absolute path to Git repository - `short` (boolean, optional): Give output in short format - `branch` (boolean, optional): Show branch and tracking info - `verbose` (boolean/number, optional): Show textual changes staged for commit - `untrackedFiles` (boolean/string, optional): Show untracked files - `ignoreSubmodules` (string, optional): Ignore changes to submodules - `pathspec` (array, optional): Limit output to given paths **Returns:** Detailed repository status information ### git_add Adds file contents to the staging area. **Inputs:** - `repoPath` (string): Absolute path to Git repository - `files` (array): List of file paths to stage **Returns:** Confirmation of staged files ### git_commit Records changes to the repository with extensive commit options. **Inputs:** - `repoPath` (string): Absolute path to Git repository - `message` (string): Commit message - `all` (boolean, optional): Automatically stage modified files - `author` (string, optional): Override author - `amend` (boolean, optional): Amend the previous commit - `gpgSign` (boolean/string, optional): GPG sign commit - `trailers` (array, optional): Add trailers to commit message - Plus many more advanced options... **Returns:** Commit confirmation with details ### git_log Shows commit history with advanced filtering and formatting. **Inputs:** - `repoPath` (string): Absolute path to Git repository - `maxCount` (number, optional): Limit number of commits - `since` (string, optional): Show commits after date - `author` (string, optional): Filter by author - `format` (string, optional): Pretty-print format - `graph` (boolean, optional): Show text-based graph - `pathspec` (array, optional): Limit to specific paths **Returns:** Formatted commit history ### git_create_branch Creates new branches with flexible options. **Inputs:** - `repoPath` (string): Absolute path to Git repository - `branchName` (string): Name of new branch - `startPoint` (string, optional): Starting commit/branch/tag - `switchToBranch` (boolean, optional): Switch to new branch (default: true) - `force` (boolean, optional): Force create, reset if exists **Returns:** Branch creation confirmation ### git_checkout Switches branches or commits with advanced options. **Inputs:** - `repoPath` (string): Absolute path to Git repository - `target` (string): Branch/commit/tag to checkout - `force` (boolean, optional): Force checkout - `createBranch` (string, optional): Create and checkout new branch - `detach` (boolean, optional): Detached HEAD mode - `pathspec` (array, optional): Limit to specific paths **Returns:** Checkout confirmation ### git_reset Resets repository state with different modes. **Inputs:** - `repoPath` (string): Absolute path to Git repository - `target` (string, optional): Target commit (default: HEAD) - `mode` (string, optional): Reset mode - soft/mixed/hard (default: mixed) - `pathspec` (array, optional): Limit to specific paths **Returns:** Reset confirmation ### git_diff Shows differences between commits, branches, or files. **Inputs:** - `repoPath` (string): Absolute path to Git repository - `from` (string, optional): Source commit/branch/tag - `to` (string, optional): Target commit/branch/tag - `staged` (boolean, optional): Show staged changes - `nameOnly` (boolean, optional): Show only changed file names - `pathspec` (array, optional): Limit to specific paths **Returns:** Diff output ### git_show Displays commit details and changes. **Inputs:** - `repoPath` (string): Absolute path to Git repository - `commit` (string, optional): Commit to show (default: HEAD) - `format` (string, optional): Pretty-print format - `stat` (boolean, optional): Show diffstat - `pathspec` (array, optional): Limit to specific paths **Returns:** Commit details and changes ### git_init Initializes a new Git repository. **Inputs:** - `repoPath` (string): Path where to initialize repository - `bare` (boolean, optional): Create bare repository - `initialBranch` (string, optional): Set initial branch name - `template` (string, optional): Template directory **Returns:** Initialization confirmation ## Installation ```json { "mcpServers": { "git": { "command": "npx", "args": ["-y", "@ver0/mcp-git"] } } } ```