Gitingest

Gitingest-MCP is an MCP server that provides structured information from GitHub repositories to MCP clients such as Claude Desktop, Cursor, Cline, and Windsurf.

Features

• 📄 Repository Summaries: Obtain concise overviews, including repository names, file listings, token counts, and README summaries.
• 🌲 Directory Structures: Access tree-like representations of project directories for better codebase understanding.
• 📂 File Content Retrieval: Fetch specific file contents directly from repositories.
• ⚙️ MCP Client Integration: Compatible with various MCP clients, enhancing workflow flexibility.
• 🛠️ Multiple Installation Methods: Install via Smithery, direct GitHub integration, or manual setup to suit different preferences.

Use Cases

• Codebase Familiarization: Quickly understand new or unfamiliar repositories by accessing summaries and structures.
• Documentation Generation: Automate the extraction of README files and directory layouts for documentation purposes.
• Code Review Preparation: Gather essential information about repositories to streamline the review process.
• Educational Purposes: Use as a teaching aid to demonstrate repository structures and contents to students or new developers.

Installation via Smithery

1. Install Smithery CLI:

npm install -g @smithery/cli

2. Install Gitingest-MCP for Your MCP Client:

• Claude Desktop:

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

• Cursor:

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

• Windsurf:

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

• Cline:

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

Installation via GitHub

1. Update MCP Client Configuration:

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

Manual Installation

1. Clone the Repository:

git clone https://github.com/puravparab/Gitingest-MCP
cd Gitingest-MCP

2. Install Dependencies:

uv sync

3. Update MCP Client Configuration:

{
 "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"
     ]
   }
 }
}

Configuring Claude Desktop

1. Open Configuration File:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

2. Add MCP Server Configuration: Insert the appropriate configuration block for Gitingest-MCP as shown above.

Debugging

• Run MCP Inspector:

uv run mcp dev src/gitingest_mcp/server.py