mcp-registry/mcp-git-ingest


    ==================
      
       /// MCP ///
      /// MCP ///
        
    ==================
        
    [server:online]
    [protocol:ready]

mcp-git-ingest

by adhikasp

A Model Context Protocol (MCP) server that reads GitHub repository structure and important files.

264

Open Source

Returns a tree-like representation of a GitHub repository’s directory structure

Reads specified files in a GitHub repository and returns their contents

Installation

1. Prerequisites

• Python 3.9 or newer

• GitHub personal-access token (classic or “fine-grained”) with repo:read scope – used by the server to pull private repositories.

2. Clone the repository

git clone https://github.com/adhikasp/mcp-git-ingest.git
cd mcp-git-ingest

3. Set up an isolated Python environment (recommended)

python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate

4. Install dependencies

# If the project ships a requirements.txt
pip install -r requirements.txt
# OR, if it uses Poetry
poetry install

5. Configure environment variables

export GITHUB_TOKEN=<your-github-token>
# Optional: server port (defaults to 8000)
export MCP_PORT=8000

6. Run the MCP server

# FastAPI / Uvicorn example
python -m mcp_git_ingest.api            # or
uvicorn mcp_git_ingest.api:app --reload --port ${MCP_PORT:-8000}

7. Verify

curl http://localhost:8000/healthz

License: MIT License

Updated 7/30/2025