What is Gitingest Mcp

gitingest-mcp is a Model Context Protocol (MCP) server implementation that integrates with gitingest to transform any Git repository into a simple text digest of its codebase.

Use cases

Use cases include generating codebase summaries for documentation, analyzing repository structures for audits, and providing insights into code changes for team collaboration.

How to use

To use gitingest-mcp, configure your AI assistant’s settings with the provided JSON configuration for PyPI, GitHub, or local installation. This will enable the MCP server for your assistant.

Key features

Key features include easy integration with AI assistants, Git repository analysis and ingestion capabilities, support for filtering files by size, patterns, and branches, and comprehensive repository information including summaries and file structures.

Where to use

gitingest-mcp can be used in software development environments, code review processes, and any context where understanding and summarizing Git repositories is necessary.

Gitingest MCP Server

A Model Context Protocol (MCP) server implementation that integrates with gitingest for turning any Git repository into a simple text digest of its codebase.

Features

• Easy integration with AI assistants through the Model Context Protocol
• Git repository analysis and ingestion capabilities
• Support for filtering files by size, patterns, and branches
• Returns comprehensive repository information including summaries, file structure, and content

Usage

Configuration Options

Add the following configuration to your AI assistant’s settings to enable gitingest-mcp as an MCP server:

PyPI Installation

{
  "mcpServers": {
    "gitingestmcp": {
      "command": "uvx",
      "args": [
        "gitingestmcp@latest"
      ]
    }
  }
}

GitHub Installation

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

Local Installation

{
  "mcpServers": {
    "gitingestmcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/home/<user>/workspace/gitingest-mcp",
        "gitingestmcp"
      ]
    }
  }
}

API

The server provides the following tool:

ingest_git

Analyzes a Git repository and returns its content in a structured format.

Parameters:

• source: The URL of a Git repository or a local directory path
• max_file_size (optional): Maximum allowed file size in bytes (default: 10MB)
• include_patterns (optional): Pattern or set of patterns specifying files to include (e.g., “*.md, src/”)
• exclude_patterns (optional): Pattern or set of patterns specifying files to exclude
• branch (optional): The branch to clone and analyze (default: “main”)

Returns:

A string containing:

1. Repository summary
2. Tree-like structure of the files
3. Content of the repository files

Resources

• gitingest website: https://gitingest.com/
• gitingest repository: https://github.com/cyclotruc/gitingest

License

See the LICENSE file for details.