mirror of
https://github.com/Shubhamsaboo/awesome-llm-apps.git
synced 2026-04-29 06:39:08 -05:00
Added github mcp agent
This commit is contained in:
ShubhamSaboo
85
mcp_ai_agents/github_mcp_agent/README.md
Normal file
85
mcp_ai_agents/github_mcp_agent/README.md
Normal file
@@ -0,0 +1,85 @@
|
||||
# 🐙 MCP GitHub Agent
|
||||
|
||||
A Streamlit application that allows you to explore and analyze GitHub repositories using natural language queries through the Model Context Protocol (MCP).
|
||||
|
||||
## 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+
|
||||
- Node.js and npm (for MCP GitHub server)
|
||||
- This is a critical requirement! The app uses `npx` to run the MCP GitHub server
|
||||
- Download and install from [nodejs.org](https://nodejs.org/)
|
||||
- GitHub Personal Access Token with appropriate permissions
|
||||
- OpenAI API Key
|
||||
|
||||
### Installation
|
||||
|
||||
1. Clone this repository:
|
||||
```bash
|
||||
git clone https://github.com/yourusername/mcp-github-agent.git
|
||||
cd mcp-github-agent
|
||||
```
|
||||
|
||||
2. Install the required Python packages:
|
||||
```bash
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
3. Verify Node.js and npm are installed:
|
||||
```bash
|
||||
node --version
|
||||
npm --version
|
||||
npx --version
|
||||
```
|
||||
All of these commands should return version numbers. If they don't, please install Node.js.
|
||||
|
||||
4. Set up your API keys:
|
||||
- Set OpenAI API Key as an environment variable:
|
||||
```bash
|
||||
export OPENAI_API_KEY=your-openai-api-key
|
||||
```
|
||||
- GitHub token will be entered directly in the app interface
|
||||
|
||||
5. Create a GitHub Personal Access Token:
|
||||
- Visit https://github.com/settings/tokens
|
||||
- Create a new token with `repo` and `user` scopes
|
||||
- Save the token somewhere secure
|
||||
|
||||
### Running the App
|
||||
|
||||
1. Start the Streamlit app:
|
||||
```bash
|
||||
streamlit run app.py
|
||||
```
|
||||
|
||||
2. In the app interface:
|
||||
- Enter your GitHub token in the sidebar
|
||||
- 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"
|
||||
149
mcp_ai_agents/github_mcp_agent/github_agent.py
Normal file
149
mcp_ai_agents/github_mcp_agent/github_agent.py
Normal file
@@ -0,0 +1,149 @@
|
||||
import asyncio
|
||||
import os
|
||||
import streamlit as st
|
||||
from textwrap import dedent
|
||||
from agno.agent import Agent
|
||||
from agno.tools.mcp import MCPTools
|
||||
from mcp import ClientSession, StdioServerParameters
|
||||
from mcp.client.stdio import stdio_client
|
||||
|
||||
# Page config
|
||||
st.set_page_config(page_title="🐙 GitHub MCP Agent", page_icon="🐙", layout="wide")
|
||||
|
||||
# Title and description
|
||||
st.markdown("<h1 class='main-header'>🐙 GitHub MCP Agent</h1>", unsafe_allow_html=True)
|
||||
st.markdown("Explore GitHub repositories with natural language using the Model Context Protocol")
|
||||
|
||||
# Setup sidebar for API key
|
||||
with st.sidebar:
|
||||
st.header("🔑 Authentication")
|
||||
github_token = st.text_input("GitHub Token", type="password",
|
||||
help="Create a token with repo scope at github.com/settings/tokens")
|
||||
|
||||
if github_token:
|
||||
os.environ["GITHUB_TOKEN"] = github_token
|
||||
|
||||
st.markdown("---")
|
||||
st.markdown("### Example Queries")
|
||||
|
||||
st.markdown("**Issues**")
|
||||
st.markdown("- Show me issues by label")
|
||||
st.markdown("- What issues are being actively discussed?")
|
||||
|
||||
st.markdown("**Pull Requests**")
|
||||
st.markdown("- What PRs need review?")
|
||||
st.markdown("- Show me recent merged PRs")
|
||||
|
||||
st.markdown("**Repository**")
|
||||
st.markdown("- Show repository health metrics")
|
||||
st.markdown("- Show repository activity patterns")
|
||||
|
||||
st.markdown("---")
|
||||
st.caption("Note: Always specify the repository in your query if not already selected in the main input.")
|
||||
|
||||
# Query input
|
||||
col1, col2 = st.columns([3, 1])
|
||||
with col1:
|
||||
repo = st.text_input("Repository", value="Shubhamsaboo/awesome-llm-apps", help="Format: owner/repo")
|
||||
with col2:
|
||||
query_type = st.selectbox("Query Type", [
|
||||
"Issues", "Pull Requests", "Repository Activity", "Custom"
|
||||
])
|
||||
|
||||
# Create predefined queries based on type
|
||||
if query_type == "Issues":
|
||||
query_template = f"Find issues labeled as bugs in {repo}"
|
||||
elif query_type == "Pull Requests":
|
||||
query_template = f"Show me recent merged PRs in {repo}"
|
||||
elif query_type == "Repository Activity":
|
||||
query_template = f"Analyze code quality trends in {repo}"
|
||||
else:
|
||||
query_template = ""
|
||||
|
||||
query = st.text_area("Your Query", value=query_template,
|
||||
placeholder="What would you like to know about this repository?")
|
||||
|
||||
# Main function to run agent
|
||||
async def run_github_agent(message):
|
||||
if not os.getenv("GITHUB_TOKEN"):
|
||||
return "Error: GitHub token not provided"
|
||||
|
||||
try:
|
||||
server_params = StdioServerParameters(
|
||||
command="npx",
|
||||
args=["-y", "@modelcontextprotocol/server-github"],
|
||||
)
|
||||
|
||||
# Create client session
|
||||
async with stdio_client(server_params) as (read, write):
|
||||
async with ClientSession(read, write) as session:
|
||||
# Initialize MCP toolkit
|
||||
mcp_tools = MCPTools(session=session)
|
||||
await mcp_tools.initialize()
|
||||
|
||||
# Create agent
|
||||
agent = Agent(
|
||||
tools=[mcp_tools],
|
||||
instructions=dedent("""\
|
||||
You are a GitHub assistant. Help users explore repositories and their activity.
|
||||
- Provide organized, concise insights about the repository
|
||||
- Focus on facts and data from the GitHub API
|
||||
- Use markdown formatting for better readability
|
||||
- Present numerical data in tables when appropriate
|
||||
- Include links to relevant GitHub pages when helpful
|
||||
"""),
|
||||
markdown=True,
|
||||
show_tool_calls=True,
|
||||
)
|
||||
|
||||
# Run agent
|
||||
response = await agent.arun(message)
|
||||
return response.content
|
||||
except Exception as e:
|
||||
return f"Error: {str(e)}"
|
||||
|
||||
# Run button
|
||||
if st.button("🚀 Run Query", type="primary", use_container_width=True):
|
||||
if not github_token:
|
||||
st.error("Please enter your GitHub token in the sidebar")
|
||||
elif not query:
|
||||
st.error("Please enter a query")
|
||||
else:
|
||||
with st.spinner("Analyzing GitHub repository..."):
|
||||
# Ensure the repository is explicitly mentioned in the query
|
||||
if repo and repo not in query:
|
||||
full_query = f"{query} in {repo}"
|
||||
else:
|
||||
full_query = query
|
||||
|
||||
result = asyncio.run(run_github_agent(full_query))
|
||||
|
||||
# Display results in a nice container
|
||||
st.markdown("### Results")
|
||||
st.markdown(result)
|
||||
|
||||
# Display help text for first-time users
|
||||
if 'result' not in locals():
|
||||
st.markdown(
|
||||
"""<div class='info-box'>
|
||||
<h4>How to use this app:</h4>
|
||||
<ol>
|
||||
<li>Enter your GitHub token in the sidebar</li>
|
||||
<li>Specify a repository (e.g., Shubhamsaboo/awesome-llm-apps)</li>
|
||||
<li>Select a query type or write your own</li>
|
||||
<li>Click 'Run Query' to see results</li>
|
||||
</ol>
|
||||
<p><strong>Important Notes:</strong></p>
|
||||
<ul>
|
||||
<li>The Model Context Protocol (MCP) provides real-time access to GitHub repositories</li>
|
||||
<li>Queries work best when they focus on specific aspects like issues, PRs, or repository info</li>
|
||||
<li>More specific queries yield better results</li>
|
||||
<li>This app requires Node.js to be installed (for the npx command)</li>
|
||||
</ul>
|
||||
</div>""",
|
||||
unsafe_allow_html=True
|
||||
)
|
||||
|
||||
# Footer
|
||||
st.markdown("---")
|
||||
st.write("Built with Streamlit, Agno, and Model Context Protocol ❤️")
|
||||
5
mcp_ai_agents/github_mcp_agent/requirements.txt
Normal file
5
mcp_ai_agents/github_mcp_agent/requirements.txt
Normal file
@@ -0,0 +1,5 @@
|
||||
streamlit>=1.28.0
|
||||
agno>=1.1.0
|
||||
mcp>=0.1.0
|
||||
openai>=1.0.0
|
||||
asyncio>=3.4.3
|
||||
Reference in New Issue
Block a user