mirror of https://github.com/Shubhamsaboo/awesome-llm-apps.git synced 2026-03-09 07:25:00 -05:00

Files

Shubhamsaboo e55a2eb5e6 feat: Update GitHub MCP Agent to use official GitHub MCP Server via Docker

- Replaced Node.js MCP server with the official GitHub MCP server running in Docker.
- Added OpenAI API key input for enhanced query processing.
- Updated README to reflect new requirements and usage instructions.

2025-10-04 10:09:02 -07:00

github_agent.py

feat: Update GitHub MCP Agent to use official GitHub MCP Server via Docker

2025-10-04 10:09:02 -07:00

README.md

feat: Update GitHub MCP Agent to use official GitHub MCP Server via Docker

2025-10-04 10:09:02 -07:00

requirements.txt

Added github mcp agent

2025-03-06 19:09:39 -08:00

README.md

🐙 GitHub MCP Agent

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!

Features

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

Setup

Requirements

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

Installation

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 repo scope

Running the App

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"

Example Queries

Issues

"Show me issues by label"
"What issues are being actively discussed?"
"Find issues labeled as bugs"

Pull Requests

"What PRs need review?"
"Show me recent merged PRs"
"Find PRs with conflicts"

Repository

"Show repository health metrics"
"Show repository activity patterns"
"Analyze code quality trends"