Git仓库分析工具

MCP Git Explorer是一个用于获取远程Git仓库内容并生成结构化文本文件的工具,支持代码库大小和令牌计数的快速估算,适用于代码分析和集成开发环境。

  • by jmiedzinski
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 jmiedzinski/mcp-git-explorer

使用说明

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提供了以下功能:

  1. 无需手动下载和上传文件即可探索Git存储库
  2. 通过自动令牌计数访问存储库的全部内容
  3. 浏览存储库结构和文件内容
  4. 在决定是否检索完整内容之前,快速评估存储库大小

何时使用哪种工具

  • 使用 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

许可证

麻省理工学院