Git MCP Server

A Model Context Protocol (MCP) server that provides enhanced Git operations through a standardized interface. This server integrates with the MCP ecosystem to provide Git functionality to AI assistants.

Features

• Core Git Operations: init, clone, status, add, commit, push, pull
• Branch Management: list, create, delete, checkout
• Tag Operations: list, create, delete
• Remote Management: list, add, remove
• Stash Operations: list, save, pop
• Bulk Actions: Execute multiple Git operations in sequence
• GitHub Integration: Built-in GitHub support via Personal Access Token
• Path Resolution: Smart path handling with optional default path configuration
• Error Handling: Comprehensive error handling with custom error types
• Repository Caching: Efficient repository state management
• Performance Monitoring: Built-in performance tracking

Installation

1. Clone the repository:

git clone https://github.com/yourusername/git-mcp-v2.git
cd git-mcp-v2

2. Install dependencies:

npm install

3. Build the project:

npm run build

Configuration

Add to your MCP settings file:

{
  "mcpServers": {
    "git-v2": {
      "command": "node",
      "args": ["path/to/git-mcp-v2/build/index.js"],
      "env": {
        "GIT_DEFAULT_PATH": "/path/to/default/git/directory",
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-github-pat"
      }
    }
  }
}

Environment Variables

• `GIT_DEFAULT_PATH`: (Optional) Default path for Git operations
• `GITHUB_PERSONAL_ACCESS_TOKEN`: (Optional) GitHub Personal Access Token for GitHub operations

Available Tools

Basic Operations

• `init`: Initialize a new Git repository
• `clone`: Clone a repository
• `status`: Get repository status
• `add`: Stage files
• `commit`: Create a commit
• `push`: Push commits to remote
• `pull`: Pull changes from remote

Branch Operations

• `branch_list`: List all branches
• `branch_create`: Create a new branch
• `branch_delete`: Delete a branch
• `checkout`: Switch branches or restore working tree files

Tag Operations

• `tag_list`: List tags
• `tag_create`: Create a tag
• `tag_delete`: Delete a tag

Remote Operations

• `remote_list`: List remotes
• `remote_add`: Add a remote
• `remote_remove`: Remove a remote

Stash Operations

• `stash_list`: List stashes
• `stash_save`: Save changes to stash
• `stash_pop`: Apply and remove a stash

Bulk Operations

• `bulk_action`: Execute multiple Git operations in sequence

Development

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Run linter
npm run lint

# Format code
npm run format

License

MIT

Contributing

1. Fork the repository

2. Create your feature branch (`git checkout -b feature/amazing-feature`)

3. Commit your changes (`git commit -m 'Add some amazing feature'`)

4. Push to the branch (`git push origin feature/amazing-feature`)

5. Open a Pull Request