# Agente GitHub MCP

> Uma aplicação Streamlit que permite explorar e analisar repositórios do GitHub utilizando consultas em linguagem natural através do Protocolo de Contexto do Modelo (MCP).

- Fonte: https://doutorai.pt/apps/github-mcp-agent
- Categoria: Agentes MCP
- Dificuldade: Avançado
- Modelos: OpenAI
- Frameworks: Agno
- Corre local?: Precisa de APIs cloud
- Chaves necessárias: GITHUB_PERSONAL_ACCESS_TOKEN, GITHUB_TOKEN, OPENAI_API_KEY
- Licença: Apache-2.0
- Site: Doutor AI (https://doutorai.pt) - ferramentas de IA para pequenos negócios em português

## Tutorial completo

# 🐙 GitHub MCP Agent

### 🎓 Tutorial Passo-a-Passo GRÁTIS
**👉 [Clica aqui para seguir o nosso tutorial completo passo-a-passo](https://www.theunwindai.com/p/build-an-mcp-github-agent-in-less-than-50-lines-of-code) 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](https://github.com/github/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](https://www.docker.com/get-started)
  - 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:

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

```markdown
# Instalação

2. Instala os pacotes Python necessários:
```

```bash
   pip install -r requirements.txt
   ```

```markdown
# 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:

```bash
docker --version
```

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

```bash
docker info
```

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

```bash
   docker --version
   docker ps
   ```

4. Obtém as tuas chaves de API:
   - **Chave da API OpenAI**: Obtém em [platform.openai.com/api-keys](https://platform.openai.com/api-keys)
   - **Token do GitHub**: Cria em [github.com/settings/tokens](https://github.com/settings/tokens) com o escopo `repo`

### Executar a Aplicação

1. Inicia a aplicação Streamlit:

```bash
   streamlit run github_agent.py
   ```

```markdown
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"
```

## Poupe horas todas as semanas com IA, sem complicações

O **Doutor AI** dá-lhe 1859 prompts de IA prontos a copiar, por indústria e em português simples - mais uma biblioteca técnica completa para quem quer ir mais longe. [Ver planos →](https://doutorai.pt/precos)

---
Conteúdo de Doutor AI (https://doutorai.pt). Ao citar, indique a fonte: https://doutorai.pt/apps/github-mcp-agent