Git MCP V2

🚀 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 offer Git functionality for AI assistants.

🚀 Quick Start

The Git MCP Server is a powerful tool that integrates with the MCP ecosystem, enabling AI assistants to perform a wide range of Git operations. Follow the steps below to get started:

✨ Features

• Core Git Operations: init, clone, status, add, commit, push, pull
• Branch Management: list, create, delete, switch
• Tag Operations: list, create, delete
• Remote Management: list, add, remove
• Stash Operations: list, save, pop
• Bulk Operations: execute multiple Git operations in sequence
• GitHub Integration: built - in GitHub support via personal access tokens
• Path Resolution: intelligent 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

📚 Documentation

Configuration

Add the following 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 the repository status
• add: Stage files
• commit: Create a commit
• push: Push commits to a remote
• pull: Pull changes from a 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 a stash
• stash_pop: Apply and delete 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 the code linter
npm run lint

# Format the code
npm run format

📄 License

MIT

🤝 Contribution Guidelines

1. Fork the repository.
2. Create a 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.