MCP Git资源管理器
简单的MCP(模型上下文协议)服务器,用于以结构化文本文件的形式获取远程git存储库内容。
特性
- 克隆和分析Git存储库
- 生成存储库内容的结构化文本表示
- 快速估计代码库大小和令牌计数,而无需检索所有内容
- 通过令牌身份验证支持公共存储库和私有GitLab存储库
- 使用OpenAI的tiktoken库进行标记化计数
- 尊重.gitignore和.remixignore模式
- 跳过二进制文件和空文本文件
- 与Claude模型上下文协议的集成
安装
来自PyPI
pip install mcp-git-explorer使用紫外线
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个人访问令牌,用于访问私有存储库
在克劳德
MCP Git Explorer为Claude提供了以下功能:
- 无需手动下载和上传文件即可探索Git存储库
- 通过自动令牌计数访问存储库的全部内容
- 浏览存储库结构和文件内容
- 在决定是否检索完整内容之前,快速评估存储库大小
何时使用哪种工具
- 使用
estimate_codebase当您想在分析存储库内容之前快速检查存储库的大小和结构时。这对于需要检查在令牌限制内检索完整内容是否可行的大型存储库特别有用。 - 使用
get_codebase当您需要分析存储库中文件的实际代码和内容时。
可用工具
get_codebase(repo_url: str, use_token: bool = True) -> str:克隆和分析Git存储库,返回完整的文件内容estimate_codebase(repo_url: str, use_token: bool = True) -> str:快速分析提供存储库统计信息,包括文件计数、结构和令牌估计check_gitlab_token_status() -> str:检查是否配置了GitLab令牌
发展
设置
# 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许可证
麻省理工学院
