mcp‑git‑ingest

Git Ingest MCP Server

0

Browse & Read GitHub Repos via MCP

Published: 8/July/2025 Views: 195

What is Git Ingest MCP Server?

mcp-git-ingest is a Model Context Protocol (MCP) server that enables LLM agents and developers to explore GitHub repositories with ease. It exposes two powerful tools:

  1. github_directory_structure – returns a tree-like representation of a repo’s files and folders.
  2. github_read_important_files – fetches the contents of specified key files (e.g., README.md, source files).

This makes it effortless to programmatically inspect codebase structure and contents for analysis, reviews, or automated documentation workflows.

Git Ingest MCP Server Key Features

  • Structured directory retrieval: get a clean, indented view of repo structure
  • File content access: selectively read important code/config files
  • Automatic cloning & cleanup: clones repositories into a temp folder and removes them when done
  • Robust error handling and deterministic temp path generation

Git Ingest MCP Server Use Cases

  • Automated codebase exploration or documentation generation
  • LLM-driven code reviews and architectural summaries
  • Integration into CI/CD pipelines for context-aware code quality checks

Installation & Setup

Requires Python ≥3.8 and uvx CLI:

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

Add this to your MCP host config (e.g., Cursor, Claude Desktop, or mcp-client-cli)

Example Usage
With an MCP-aware CLI:

llm read https://github.com/adhikasp/mcp‑git‑ingest and show me the directory structure
llm read https://github.com/adhikasp/mcp‑git‑ingest and fetch README.md and src/main.py

The server will automatically:

  • Call github_directory_structure

  • Then github_read_important_files