GitHub Repository Analyzer

An LLM-powered GitHub repository analysis tool that allows users to provide a GitHub repository URL and ask natural-language questions about the repository.

The application retrieves repository information and source code through GitHub APIs exposed as MCP tools, then uses a local LLM to generate answers grounded in the retrieved repository evidence.

Features

• Analyze different GitHub repositories from the terminal

• Accept the repository URL separately from the question

• Ask questions in natural language

• Ask high-level repository questions

• Ask implementation questions about functions and code

• Search repository source code

• Read specific repository files or line ranges

• Retrieve repository metadata

• Retrieve repository file structure

• Use MCP to expose repository operations as tools

• Use LangGraph to manage the analysis workflow

• Use a local LLM through Ollama

• Ground implementation answers in retrieved repository source code

• Retry temporary GitHub API failures

Related MCP server: AI Project Explorer

Architecture

                    User
                     |
                     v
                 main.py
                     |
                     v
                LangGraph
                 graph.py
                     |
                     v
                 MCP Client
               mcp_client.py
                     |
                     v
                 MCP Server
               mcp_server.py
                     |
                     v
             repository_tools.py
                     |
                     v
              github_client.py
                     |
                     v
              GitHub REST API
                     |
                     v
          Repository Information
          and Source Code
                     |
                     v
                    LLM
                     |
                     v
                Final Answer