Gitingest

Gitingest-MCP is an MCP server that surfaces information about GitHub repositories for MCP clients. It enables quick extraction of repository summaries, project directory structures, and file content for downstream tooling and automation.

How to use

You will run the MCP server locally and connect your MCP client to it. When connected, the server exposes endpoints that let you fetch a repository summary, browse the project directory, and retrieve file contents. Use the MCP client’s integration flow to request data on a repository you specify, then render or analyze it in your editor or tooling.

How to install

Prerequisites you need before installing:
- Node.js and npm (for client install flows) or Python (for server-side script in this MCP path).
- uv/uvx runtime for executing MCP servers locally.
- An MCP client you intend to pair with (for example Claude Desktop, Cursor, etc.).

# Installing via Smithery (client-side installer flow)
# Claude client
npx -y @smithery/cli@latest install @puravparab/gitingest-mcp --client claude --config "{}"

# Cursor client
npx -y @smithery/cli@latest run @puravparab/gitingest-mcp --client cursor --config "{}"

# Windsurf client
npx -y @smithery/cli@latest install @puravparab/gitingest-mcp --client windsurf --config "{}"

# Cline client
npx -y @smithery/cli@latest install @puravparab/gitingest-mcp --client cline --config "{}"
``n

Installing via Github

If you prefer configuring your MCP client to use a direct MCP URL, add the following MCP server block to your client configuration. This config uses the uv runtime to run the server from the Git repository path.

{
  "mcpServers": {
    "gitingest-mcp": {
      "command": "<path to uv>/uvx",
      "args": [
        "--from",
        "git+https://github.com/puravparab/gitingest-mcp",
        "gitingest-mcp"
      ]
    }
  }
}

Installing Repo Manually

To install from source, clone the repository, install dependencies, and configure your MCP client to run the server script with uv.

# Clone the MCP server repository
git clone https://https://github.com/puravparab/Gitingest-MCP
cd Gitingest-MCP

# Install dependencies (using uvx for Python-based MCP runtimes)
uv sync

MCP client configuration example for manual install

This configuration demonstrates how to run the MCP server using uv and point the client to the server script.

{
  "mcpServers": {
    "gitingest": {
      "command": "<path to uv>/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with-editable",
        "<path to gitingest-mcp project>/gitingest_mcp",
        "mcp",
        "run",
        "<path to gitingest-mcp project>/gitingest-mcp/src/gitingest_mcp/server.py"
      ]
    }
  }
}

Debug

If you want to test the MCP server in a development loop, you can run a live inspection using the MCP runtime.

uv run mcp dev src/gitingest_mcp/server.py

Available tools

getRepoSummary

Fetches a brief summary of the repository including description, stars, and last updated date.

listDirectoryTree

Retrieves the project directory structure, listing folders and files in a hierarchical view.

getFileContent

Retrieves the content of a specified file within the repository, returning code or text content.