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

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