MCP Git Explorer

🚀 MCP Git Explorer

A simple MCP (Model Context Protocol) server that fetches content from remote Git repositories and presents it in a structured text format.

🚀 Quick Start

The MCP Git Explorer is a tool designed to simplify the process of accessing and analyzing Git repositories. It offers a range of features that make it easier to work with both public and private repositories.

✨ Features

• Clone and analyze Git repositories.
• Generate a structured text representation of the repository content.
• Quickly estimate the codebase size and token count without fetching all content.
• Support public repositories and private GitLab repositories with token authentication.
• Use OpenAI's tiktoken library for token counting.
• Respect .gitignore and .repomixignore patterns.
• Ignore binary files and empty text files.
• Integrate with Claude's Model Context Protocol.

📦 Installation

Install from PyPI

pip install mcp-git-explorer

Install using uv

uv pip install mcp-git-explorer

Run directly with uvx (no installation required)

uvx mcp-git-explorer

💻 Usage Examples

As a Command-Line Tool

# Basic usage
mcp-git-explorer

# Use SSE transport
mcp-git-explorer --transport sse

# Provide a GitLab token
mcp-git-explorer --gitlab-token YOUR_TOKEN

Environment Variables

• GIT_EXPLORER_GITLAB_TOKEN: Your GitLab personal access token for accessing private repositories.

Usage in Claude

The MCP Git Explorer empowers Claude with the following capabilities:

1. Explore Git repositories without manually downloading and uploading files.
2. Access the entire repository content and automatically perform token counting.
3. Navigate across the repository structure and file content.
4. Quickly assess the repository size before deciding to fetch the full content.

Use Cases

• Use estimate_codebase when you want to quickly check the size and structure of a repository (especially when dealing with large repositories) to determine if it's worth fetching the full content.
• Use get_codebase when you need to analyze the actual code and file content.

Available Tools

• get_codebase(repo_url: str, use_token: bool = True) -> str: Clone and analyze a Git repository, returning the full file content.
• estimate_codebase(repo_url: str, use_token: bool = True) -> str: Quickly analyze and provide repository statistics, including the number of files, structure, and token estimation.
• check_gitlab_token_status() -> str: Check if a GitLab token is configured.

🔧 Technical Details

Set Up the Environment

# Clone the repository
git clone https://github.com/jmiedzinski/mcp-git-explorer.git
cd mcp-git-explorer

# Install development dependencies
uv pip install -e ".[dev]"

Run Locally

# Run directly
python -m mcp_git_explorer.cli

# Run using MCP CLI
mcp dev mcp_git_explorer/cli.py

# Run using uvx
uvx mcp-git-explorer

📄 License

MIT