Positronikal/gitProMCP

git Professional MCP

A comprehensive Model Context Protocol server for advanced Git repository interaction and automation, featuring breakthrough AI capabilities for cross-repository project awareness.

🚀 Breakthrough AI Capability

git Professional MCP delivers the first consumer-accessible AI with cross-repository project awareness. Through our git_multi_status tool, AI can now:

• Discover and monitor dozens of repositories simultaneously across your development workspace
• Provide real-time status awareness of multiple projects with change detection, branch tracking, and sync status
• Enable intelligent project coordination by understanding relationships between repositories
• Deliver parallel processing efficiency for large-scale repository management

This represents a fundamental advancement in AI-powered development workflow management that no other consumer-accessible AI system currently provides.

Key Features

Enhanced Repository Discovery

• Secure Auto-Discovery: Opt-in repository detection with security-first design
• Multiple Repository Support: Monitor dozens of repositories simultaneously
• Intelligent Path Resolution: Automatically resolves file paths to containing repositories
• Configurable Scanning: Customizable depth limits and exclusion patterns

Comprehensive Git Operations

Complete coverage of essential Git workflows including status checking, branching, committing, staging, diffing, logging, and advanced operations like visual commit graphs.

Professional Development Tools

• MCP Inspector Integration: Interactive testing and debugging environment
• Comprehensive Test Coverage: 84.44% test coverage with rationalized test suite
• Security-First Design: Bounded scanning, audit logging, and performance safeguards
• Multiple Installation Methods: uv, pip, Docker, and Windows executable options

Quick Start

Installation

Using uv (recommended):

uvx mcp-server-git --repository /path/to/your/repo

Using pip:

pip install mcp-server-git
python -m mcp_server_git --repository /path/to/your/repo

With Auto-Discovery:

uvx mcp-server-git --enable-discovery --max-discovery-depth 2

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "git": {
      "command": "uvx",
      "args": [
        "mcp-server-git", 
        "--enable-discovery",
        "--max-discovery-depth", "2"
      ]
    }
  }
}

Sample configurations for various use cases are available in the rel/ directory.

Core Tools

Repository Management:

• git_discover_repositories - Secure repository auto-discovery
• git_multi_status ⭐ - Multi-repository cross-project awareness
• git_status, git_diff_* - Standard repository status operations

Branching & History:

• git_branch, git_create_branch, git_checkout - Branch management
• git_log, git_log_graph - Commit history with visual graphs
• git_show - Detailed commit inspection

Workflow Operations:

• git_add, git_commit, git_reset - Standard Git workflow
• git_init - Repository initialization

Advanced Features

Multi-Repository Status (git_multi_status)

The breakthrough feature enabling AI cross-project awareness:

• Simultaneous monitoring of multiple repositories
• Change detection across your entire development workspace
• Branch synchronization status tracking
• Parallel processing for performance at scale

Visual Commit Graphs (git_log_graph)

ASCII visual representation of branch relationships and commit history with configurable output formats for different detail levels.

Secure Repository Discovery

• Automatic detection of Git repositories within allowed paths
• Security-first design with bounded scanning and audit logging
• Configurable exclusion patterns and depth limits
• Cache management with TTL-based cleanup

Documentation & Support

• Installation & Usage: See USING.md for detailed instructions
• Bug Reports: See BUGS.md for reporting guidelines and troubleshooting
• Security: See SECURITY.md for responsible disclosure
• Contributing: See CONTRIBUTING.md for development guidelines

Development & Testing

MCP Inspector

Professional testing environment for interactive development:

npx @modelcontextprotocol/inspector uvx mcp-server-git --enable-discovery

Access at http://localhost:6274 for real-time testing and debugging.

Project Structure

• src/ - Core MCP server implementation
• tests/ - Comprehensive test suite
• rel/ - Sample configurations and deployment files
• tools/ - Development and utility scripts
• .github/ - CI/CD workflows and automation

License & Attribution

This project is licensed under the GNU General Public License v3. See COPYING.md for details.

This is a derivative work based on Anthropic's original git MCP server, enhanced with professional features and security improvements. See ATTRIBUTION.md for complete attribution information.

Platform Support

• Cross-Platform: Windows, macOS, Linux
• MCP Clients: Claude Desktop, VS Code, Zed
• Python: 3.8+ with comprehensive dependency management
• Deployment: Manual installation, uvx, pip, Docker, Windows executable

Professional Development: Built with enterprise-grade testing, security, and deployment practices for reliable production use.