What is Git Mcp V2

git-mcp-v2 is a Model Context Protocol (MCP) server that enhances Git operations through a standardized interface, integrating with the MCP ecosystem to provide Git functionality for AI assistants.

Use cases

Use cases include automating Git workflows for AI assistants, managing repositories in collaborative projects, integrating Git operations into applications, and enhancing performance monitoring for Git operations.

How to use

To use git-mcp-v2, clone the repository, install dependencies, and build the project. Configure the MCP settings file to include the server command and environment variables for Git operations and GitHub integration.

Key features

Key features include core Git operations (init, clone, status, add, commit, push, pull), branch management, tag operations, remote management, stash operations, bulk actions, GitHub integration, smart path resolution, comprehensive error handling, repository caching, and performance monitoring.

Where to use

git-mcp-v2 can be used in software development environments, particularly where Git operations need to be automated or integrated with AI systems, such as CI/CD pipelines and collaborative development tools.

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