mcp-git-ingest

Overview

The mcp-git-ingest server provides two main tools: github_directory_structure for exploring repository hierarchies and github_read_important_files for extracting content from specific files. It uses GitPython to clone repositories temporarily and generate tree representations with Unicode characters. The implementation includes proper error handling, cleanup mechanisms to prevent temporary file accumulation, and optimizations through hash-based directory naming to potentially reuse cloned repositories.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• github_directory_structuregithub_directory_structure(repo_url: str) -> str

  Returns a tree-like representation of a repository's directory structure

  Try:Show me the directory structure of the https://github.com/adhikasp/mcp-git-ingest repositoryTry:What files are in the main directory of https://github.com/example/repoTry:List the folder structure of this GitHub repository
• github_read_important_filesgithub_read_important_files(repo_url: str, file_paths: List[str]) -> dict[str, str]

  Reads and returns the contents of specified files in a repository

  Try:Read the README.md and pyproject.toml files from https://github.com/adhikasp/mcp-git-ingestTry:What are the contents of the main.py file in this repositoryTry:Get the content of these files: README.md, src/main.py, and requirements.txt

Comparable tools

Installation

uvx --from git+https://github.com/adhikasp/mcp-git-ingest mcp-git-ingest

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

FAQ

Does this server clone the entire repository to my machine?

No, it clones repositories to temporary directories and ensures they're cleaned up after processing.

What happens if I request a file from a private repository?

The server will fail to clone the repository unless you've configured authentication properly for git operations.

Compare mcp-git-ingest with