h Operations](#branch-operations) - [Working Directory Operations](#working-directory-operations) - [Remote Operations](#remote-operations) - [Advanced Operations](#advanced-operations) - [Resources](#resources) - [Repository Resources](#repository-resources) - [Development](#development) - [Build and Test](#build-and-test) - [License](#license) ## Overview Key capabilities: - **Repository Management**: Initialize, clone, and check repository status - **Branch Operations**: Create, list, checkout, delete, and merge branches - **Working Directory**: Stage files, commit changes, create diffs - **Remote Operations**: Add remotes, fetch, pull, push - **Advanced Git Commands**: Manage tags, stash changes, cherry-pick, rebase ### Architecture & Components Core system architecture:

Click to expand Mermaid diagram

```mermaid flowchart TB subgraph API["API Layer"] direction LR MCP["MCP Protocol"] Val["Validation"] MCP --> Val end subgraph Core["Core Services"] direction LR GitService["Git Service"] ErrorService["Error Service"] GitService <--> ErrorService end subgraph Resources["Resource Layer"] direction LR Repo["Repository Resources"] Diff["Diff Resources"] File["File Resources"] History["History Resources"] Repo <--> Diff Repo <--> File Repo <--> History end subgraph Tools["Tool Layer"] direction LR RepoTools["Repository Tools"] BranchTools["Branch Tools"] WorkdirTools["Working Directory Tools"] RemoteTools["Remote Tools"] AdvancedTools["Advanced Tools"] RepoTools <--> BranchTools BranchTools <--> WorkdirTools WorkdirTools <--> RemoteTools RemoteTools <--> AdvancedTools end Val --> GitService GitService --> Resources GitService --> Tools classDef layer fill:#2d3748,stroke:#4299e1,stroke-width:3px,rx:5,color:#fff classDef component fill:#1a202c,stroke:#a0aec0,stroke-width:2px,rx:3,color:#fff classDef api fill:#3182ce,stroke:#90cdf4,stroke-width:2px,rx:3,color:#fff classDef core fill:#319795,stroke:#81e6d9,stroke-width:2px,rx:3,color:#fff classDef resource fill:#2f855a,stroke:#9ae6b4,stroke-width:2px,rx:3,color:#fff classDef tool fill:#805ad5,stroke:#d6bcfa,stroke-width:2px,rx:3,color:#fff class API,Core,Resources,Tools layer class MCP,Val api class GitService,ErrorService core class Repo,Diff,File,History resource class RepoTools,BranchTools,WorkdirTools,RemoteTools,AdvancedTools tool ```

Core Components: - **MCP Server**: Uses the Model Context Protocol SDK to create a server that exposes resources and tools - **Git Service**: Abstraction layer over simple-git to provide clean interfaces for Git operations - **Resources**: Expose Git data through MCP resources with consistent URI templates - **Tools**: Expose Git operations through MCP tools with well-defined schemas - **Error Handling**: Standardized error handling and reporting ## Features ### Resource Access Expose Git repository information through MCP resources: - **Repository Information**: Access basic Git repository information including current branch, status, and reference details - **Repository Branches**: List all branches in the repository with current branch indicator - **Repository Remotes**: List all configured remote repositories with their URLs - **Repository Tags**: List all tags in the repository with their references - **File Content**: Access content of specific files at a given Git reference - **Directory Listing**: View lists of files and directories at a specific path and reference - **Diffs**: Get differences between references, unstaged changes, or staged changes - **Commit History**: View detailed commit logs with author, date, and message information - **File Blame**: See line-by-line attribution showing which commit last modified each line - **Commit Details**: Access detailed inform

GIT MCP Server

Tools