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