Skip to content

narumiruna/gitingest-mcp

Repository files navigation

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.

Gitingest Server MCP server

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

License

See the LICENSE file for details.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published