👉 Click here to follow our complete step-by-step tutorial and learn how to build this from scratch with detailed code walkthroughs, explanations, and best practices.
A Streamlit application that allows you to explore and analyze GitHub repositories using natural language queries through the Model Context Protocol (MCP).
✨ Now using the official GitHub MCP Server from GitHub!
- Natural Language Interface: Ask questions about repositories in plain English
- Comprehensive Analysis: Explore issues, pull requests, repository activity, and code statistics
- Interactive UI: User-friendly interface with example queries and custom input
- MCP Integration: Leverages the Model Context Protocol to interact with GitHub's API
- Real-time Results: Get immediate insights on repository activity and health
- Python 3.8+
- Docker (for official GitHub MCP server)
- Download and install from docker.com
- Make sure Docker is running before starting the app
- OpenAI API Key
- GitHub Personal Access Token
-
Clone this repository:
git clone https://github.com/Shubhamsaboo/awesome-llm-apps.git cd mcp-github-agent -
Install the required Python packages:
pip install -r requirements.txt
-
Verify Docker is installed and running:
docker --version docker ps
-
Get your API keys:
- OpenAI API Key: Get from platform.openai.com/api-keys
- GitHub Token: Create at github.com/settings/tokens with
reposcope
-
Start the Streamlit app:
streamlit run github_agent.py
-
In the app interface:
- Enter your OpenAI API key
- Enter your GitHub token
- Specify a repository to analyze
- Select a query type or write your own
- Click "Run Query"
- "Show me issues by label"
- "What issues are being actively discussed?"
- "Find issues labeled as bugs"
- "What PRs need review?"
- "Show me recent merged PRs"
- "Find PRs with conflicts"
- "Show repository health metrics"
- "Show repository activity patterns"
- "Analyze code quality trends"