mcp-git-explorer 0.1.0

Simple MCP server for fetching the remote git repository content as a structured text file

MCP Git Explorer

A tool for exploring Git repositories through Claude using the Model Context Protocol (MCP).

Features

• Clone and analyze Git repositories
• Generate a structured text representation of repository contents
• Support for public repositories and private GitLab repositories with token authentication
• Tokenization counting using OpenAI's tiktoken library
• Respect for .gitignore and .repomixignore patterns
• Skip binary files and empty text files
• Integration with Claude's Model Context Protocol

Installation

From PyPI

pip install mcp-git-explorer

Using uv

uv pip install mcp-git-explorer

Direct execution with uvx (without installation)

uvx mcp-git-explorer

Usage

As a command-line tool

# Basic usage
mcp-git-explorer

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

# Providing GitLab token
mcp-git-explorer --gitlab-token YOUR_TOKEN

Environment Variables

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

In Claude

MCP Git Explorer provides Claude with the ability to:

1. Explore Git repositories without needing to manually download and upload files
2. Access the full contents of repositories, with automatic token counting
3. Navigate through repository structure and file contents

Available Tools

• get_codebase(repo_url: str, use_token: bool = True) -> str: Clone and analyze a Git repository
• check_gitlab_token_status() -> str: Check if a GitLab token is configured

Development

Setup

# 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]"

Running locally

# Run directly
python -m mcp_git_explorer.cli

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

License

MIT