MCP Git Explorer

用于获取远程 git 仓库内容作为结构化文本文件的简单 MCP (模型上下文协议) 服务器。

特性

• 克隆和分析 Git 仓库
• 生成仓库内容的结构化文本表示
• 无需检索所有内容即可快速估计代码库大小和 token 数量
• 支持公共仓库和使用 token 认证的私有 GitLab 仓库
• 使用 OpenAI 的 tiktoken 库进行 token 计数
• 尊重 .gitignore 和 .repomixignore 模式
• 跳过二进制文件和空文本文件
• 与 Claude 的模型上下文协议集成

安装

从 PyPI

pip install mcp-git-explorer

使用 uv

uv pip install mcp-git-explorer

使用 uvx 直接执行 (无需安装)

uvx mcp-git-explorer

用法

作为命令行工具

# 基本用法
mcp-git-explorer

# 使用 SSE 传输
mcp-git-explorer --transport sse

# 提供 GitLab token
mcp-git-explorer --gitlab-token YOUR_TOKEN

环境变量

• GIT_EXPLORER_GITLAB_TOKEN: 您的 GitLab 个人访问 token，用于访问私有仓库

在 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

开发

设置

# 克隆仓库
git clone https://github.com/jmiedzinski/mcp-git-explorer.git
cd mcp-git-explorer

# 安装开发依赖
uv pip install -e ".[dev]"

本地运行

# 直接运行
python -m mcp_git_explorer.cli

# 通过 MCP CLI 运行
mcp dev mcp_git_explorer/cli.py

# 通过 uvx 运行
uvx mcp-git-explorer

许可证

MIT