MCP Git Explorer

MCP Git Explorer

一个简单的 MCP（Model Context Protocol）服务，用于将远程 Git 仓库内容获取为结构化文本文件。

功能

• 克隆并分析 Git 仓库
• 生成仓库内容的结构化文本表示
• 无需获取全部内容，即可快速估算代码库大小和 token 数量
• 支持公共仓库和通过 token 身份验证的私有 GitLab 仓库
• 使用 OpenAI 的 tiktoken 库统计 token 数量
• 遵循 .gitignore 和 .repomixignore 模式
• 跳过二进制文件和空文本文件
• 与 Claude 的 Model Context Protocol 集成

安装

从 PyPI 安装

pip install mcp-git-explorer

使用 uv

uv pip install mcp-git-explorer

使用 uvx 直接运行（无需安装）

uvx mcp-git-explorer

用法

作为命令行工具

# Basic usage
mcp-git-explorer

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

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

环境变量

• GIT_EXPLORER_GITLAB_TOKEN：用于访问私有仓库的 GitLab 个人访问令牌

在 Claude 中使用

MCP Git Explorer 让 Claude 能够：

1. 无需手动下载和上传文件，即可探索 Git 仓库
2. 访问仓库的完整内容，并自动统计 token 数量
3. 浏览仓库结构和文件内容
4. 在决定是否获取完整内容前，快速评估仓库大小

如何选择工具

• 如果想在分析仓库内容前快速检查其大小和结构，请使用 estimate_codebase。这对大型仓库尤其有用，可帮助你确认在 token 限制内获取完整内容是否可行。
• 如果需要分析仓库中的实际代码和文件内容，请使用 get_codebase。

可用工具

• get_codebase(repo_url: str, use_token: bool = True) -> str：克隆并分析 Git 仓库，返回完整文件内容
• estimate_codebase(repo_url: str, use_token: bool = True) -> str：快速分析并提供仓库统计信息，包括文件数、结构和 token 数量估算
• check_gitlab_token_status() -> str：检查是否已配置 GitLab token

开发

设置

# 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 directly
python -m mcp_git_explorer.cli

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

# Run via uvx
uvx mcp-git-explorer

许可证

MIT