MCP Git Ingest

一个模型上下文协议 (MCP) 服务器，用于帮助读取 GitHub 仓库结构和重要文件。

灵感来自 gitingest。

<a href="https://glama.ai/mcp/servers/un2zatig9e"><img width="380" height="200" src="https://glama.ai/mcp/servers/un2zatig9e/badge" /></a>

配置

{
    "mcpServers": {
        "mcp-git-ingest": {
            "command": "uvx",
            "args": ["--from", "git+https://github.com/adhikasp/mcp-git-ingest", "mcp-git-ingest"],
        }
    }
}

用法

使用 mcp-client-cli:

$ llm read https://github.com/adhikasp/mcp-git-ingest 并确定代码在技术上是如何工作的

我将帮助你理解 mcp-git-ingest 仓库的技术细节。我将首先获取目录结构，然后读取重要文件以分析代码的工作方式。

工具调用:
  github_directory_structure
  参数:
    repo_url: https://github.com/adhikasp/mcp-git-ingest

现在，我将读取重要文件以了解技术实现：

工具调用:
  github_read_important_files
  参数:
    repo_url: https://github.com/adhikasp/mcp-git-ingest
    file_paths: ['README.md', 'src/mcp_git_ingest/main.py', 'pyproject.toml']

让我分解一下这段代码在技术上是如何工作的：

1. 目的：
`mcp-git-ingest` 是一个模型上下文协议 (MCP) 服务器，旨在帮助读取 GitHub 仓库结构和重要文件。 它提供了两个主要工具：
- `github_directory_structure`: 返回仓库目录结构的树状表示
- `github_read_important_files`: 读取并返回仓库中指定文件的内容

2. 技术实现：

a. 依赖项：
- 使用 `fastmcp` 创建 MCP 服务器
- 使用 `gitpython` 进行 Git 仓库操作
- 需要 Python 3.8+

b. 关键函数：

`clone_repo(repo_url: str) -> str`:
- 基于仓库 URL 的哈希值创建一个确定性的临时目录
- 检查仓库是否已被克隆
- 如果没有，则克隆仓库
- 处理错误情况和清理
- 返回克隆仓库的路径

`get_directory_tree(path: str, prefix: str = "") -> str`:
- 递归生成树状目录结构
- 跳过 `.git` 目录
- 使用 Unicode 框图字符创建可视化树表示
- 处理条目的排序

`github_directory_structure(repo_url: str) -> str`:
- 克隆仓库
- 生成目录树
- 处理后清理临时仓库
- 返回树结构或错误消息

`github_read_important_files(repo_url: str, file_paths: List[str]) -> dict[str, str]`:
- 克隆仓库
- 读取指定文件
- 返回一个字典，将文件路径映射到它们的内容
- 处理文件读取错误
- 清理临时仓库

3. 错误处理：
- 使用 try-except 块来处理仓库克隆、文件读取错误
- 确保始终使用 `finally` 块清理临时目录
- 返回描述性错误消息

4. 性能优化：
- 使用基于哈希的临时目录命名来潜在地重用克隆的仓库
- 在克隆之前检查现有仓库
- 实施清理以防止临时文件累积

5. 独特功能：
- 确定性临时目录创建
- Unicode 树表示
- 灵活的文件读取和错误处理

6. 执行：
- 可以通过 `mcp-git-ingest` 作为 CLI 工具运行
- 通过 `pyproject.toml` 配置
- 依赖于 `fastmcp` 以实现 MCP 服务器功能

该代码是一个强大、灵活的工具，用于以编程方式探索和读取 GitHub 仓库，重点是错误处理和干净的实现。

您希望我详细说明实现的任何特定方面吗？