GitHub MCP Agent

streamlit run main.py

import os
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

server_params = StdioServerParameters(
    command="docker",
    args=[
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
    ],
    env={
        "GITHUB_PERSONAL_ACCESS_TOKEN": os.getenv("GITHUB_PERSONAL_ACCESS_TOKEN")
    }
)

from agno.tools.mcp import MCPTools

# 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()
        
        # Now use mcp_tools with agent

from agno.agent import Agent
from agno.models.nebius import Nebius
from textwrap import dedent

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
        - For Info, Provide Details from the Repository's README.md file
        - For Issues, Provide Details from the Issues section
        - For Pull Requests, Provide Details from the PRs section
        - 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
        - IMPORTANT: When using MCP tools that require numeric parameters,
          ensure they are passed as float64 values
        - For date-related parameters (like 'since' in list_issues),
          always provide a valid ISO 8601 formatted date string
    """),
    markdown=True,
    show_tool_calls=True,
    model=Nebius(
        id="Qwen/Qwen3-30B-A3B",
        api_key=api_key
    )
)

async def run_github_agent(message):
    """Run agent with proper error handling."""
    try:
        async with stdio_client(server_params) as (read, write):
            async with ClientSession(read, write) as session:
                mcp_tools = MCPTools(session=session)
                await mcp_tools.initialize()
                
                agent = Agent(
                    tools=[mcp_tools],
                    instructions="...",
                    model=Nebius(id="Qwen/Qwen3-30B-A3B", api_key=api_key)
                )
                
                response = await agent.arun(message)
                return response.content
    except Exception as e:
        return f"Error: {str(e)}"

import streamlit as st
import base64

st.set_page_config(
    page_title="GitHub MCP Agent", 
    page_icon="🦑", 
    layout="wide"
)

# Load and display logo
try:
    with open("./assets/agno.png", "rb") as agno_file:
        agno_base64 = base64.b64encode(agno_file.read()).decode()
except FileNotFoundError:
    st.error("Logo file not found.")
    agno_base64 = ""

with st.sidebar:
    st.image("./assets/Nebius.png", width=150)
    
    st.header("🔑 Authentication")
    api_key = st.text_input(
        "Enter your Nebius API key", 
        type="password"
    )
    
    if api_key:
        os.environ["NEBIUS_API_KEY"] = api_key
    
    github_token = st.text_input(
        "GitHub Token", 
        type="password",
        help="Create token at github.com/settings/tokens"
    )
    
    if github_token:
        os.environ["GITHUB_PERSONAL_ACCESS_TOKEN"] = github_token

col1, col2 = st.columns([3, 1])

with col1:
    repo = st.text_input(
        "Repository", 
        value="Arindam200/awesome-ai-apps",
        help="Format: owner/repo"
    )

with col2:
    query_type = st.selectbox(
        "Query Type", 
        ["Info", "Issues", "Pull Requests", "Repository Activity", "Custom"]
    )

query = st.text_area(
    "Your Query", 
    value=query_template,
    placeholder="What would you like to know about this repository?"
)

from agno.tools.mcp import MCPTools

# Add custom tool implementation
class CustomGitHubTools(MCPTools):
    async def get_custom_metrics(self, repo: str):
        # Custom implementation
        pass

from agno.agent import Agent

# Specialized agents
code_analyzer = Agent(name="Code Analyzer", ...)
issue_tracker = Agent(name="Issue Tracker", ...)
pr_reviewer = Agent(name="PR Reviewer", ...)

# Orchestrator agent
orchestrator = Agent(
    name="GitHub Orchestrator",
    agents=[code_analyzer, issue_tracker, pr_reviewer],
    ...
)