Agente GitHub MCP

🎓 Tutorial Passo-a-Passo GRÁTIS

👉 Clica aqui para seguir o nosso tutorial completo passo-a-passo e aprende como construir isto do zero com explicações detalhadas e melhores práticas.

Uma aplicação Streamlit que te permite explorar e analisar repositórios do GitHub utilizando consultas em linguagem natural através do Model Context Protocol (MCP).

✨ Agora a usar o GitHub MCP Server oficial do GitHub!

Funcionalidades

• Interface em Linguagem Natural: Faz perguntas sobre repositórios em inglês simples
• Análise Abrangente: Explora problemas, pull requests, atividade do repositório e estatísticas de código
• UI Interativa: Interface amigável com consultas de exemplo e entrada personalizada
• Integração MCP: Utiliza o Model Context Protocol para interagir com a API do GitHub
• Resultados em Tempo Real: Obtém insights imediatos sobre a atividade e saúde do repositório

Configuração

Requisitos

• Python 3.8+
• Docker (para o servidor oficial do GitHub MCP)
• Faz o download e instala a partir de docker.com
• Certifica-te de que o Docker está a correr antes de iniciares a aplicação
• Chave da API OpenAI
• Token de Acesso Pessoal do GitHub

Instalação

1. Clona este repositório:

   git clone https://github.com/Shubhamsaboo/awesome-llm-apps.git
   cd mcp-github-agent

Instalação

2. Instala os pacotes Python necessários:

   pip install -r requirements.txt

3. Verifica se o Docker está instalado e a correr:

Para verificar se o Docker está instalado e a funcionar corretamente, executa o seguinte comando no terminal:

docker --version

Se o Docker estiver instalado, deves ver a versão instalada. Para garantir que o Docker está a correr, executa:

docker info

Se o Docker estiver a funcionar, deves obter informações sobre a configuração do Docker e os containers em execução.

   docker --version
   docker ps

4. Obtém as tuas chaves de API:

• Chave da API OpenAI: Obtém em platform.openai.com/api-keys
• Token do GitHub: Cria em github.com/settings/tokens com o escopo repo

Executar a Aplicação

1. Inicia a aplicação Streamlit:

   streamlit run github_agent.py

2. Na interface da aplicação:

• Introduz a tua chave de API da OpenAI
• Introduz o teu token do GitHub
• Especifica um repositório para analisar
• Seleciona um tipo de consulta ou escreve a tua própria
• Clica em "Run Query"

Consultas de Exemplo

Problemas

• "Mostra-me problemas por etiqueta"
• "Quais problemas estão a ser discutidos ativamente?"
• "Encontra problemas rotulados como bugs"

Pull Requests

• "Quais PRs precisam de revisão?"
• "Mostra-me PRs recentemente fundidos"
• "Encontra PRs com conflitos"

Repositório

• "Mostra métricas de saúde do repositório"
• "Mostra padrões de atividade do repositório"
• "Analisa tendências de qualidade de código"