# Assistente Inteligente Multi-MCP

> O Assistente Inteligente Multi-MCP é uma ferramenta de produtividade poderosa que integra múltiplos servidores Model Context Protocol (MCP) para fornecer acesso contínuo a serviços como GitHub, Perplexity, Calendário e Gmail através de interações em linguagem natural.

- Fonte: https://doutorai.pt/apps/multi-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, PERPLEXITY_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

# 🚀 Assistente Inteligente Multi-MCP

O Assistente Inteligente Multi-MCP é uma poderosa ferramenta de produtividade que integra múltiplos servidores Model Context Protocol (MCP) para fornecer acesso contínuo aos serviços GitHub, Perplexity, Calendário e Gmail através de interações em linguagem natural. Este avançado assistente de IA é alimentado pelo framework AI Agent da Agno e foi concebido para ser um multiplicador de produtividade no teu espaço de trabalho digital.

## Funcionalidades

- **Sistema Multi-Agente**
    - **Integração com GitHub**: Gestão completa de repositórios, rastreamento de problemas e análise de código
    - **Pesquisa Perplexity**: Pesquisa na web em tempo real e recolha de informações
    - **Gestão de Calendário**: Agendamento de eventos e coordenação de reuniões
    - **Integração com Gmail**: Gestão de e-mails e fluxos de comunicação

- **Capacidades Principais**:
  - Gestão de repositórios (criar, clonar, bifurcar, pesquisar)
  - Fluxo de trabalho de problemas e PR (criar, atualizar, rever, mesclar, comentar)
  - Pesquisa na web e investigação em tempo real
  - Agendamento de eventos e gestão de disponibilidade
  - Organização de e-mails e respostas automáticas
  - Automação de fluxos de trabalho entre plataformas

- **Funcionalidades Avançadas**:
  - CLI interativa com respostas em streaming
  - Memória de conversação e retenção de contexto
  - Encadeamento de ferramentas para fluxos de trabalho complexos
  - IDs de utilizador e sessão específicos para cada sessão
  - Respostas formatadas em Markdown
  - Sugestões proativas de fluxos de trabalho

- **Foco na Produtividade**:
  - Automação entre plataformas (problemas do GitHub → eventos do Calendário)
  - Fluxos de trabalho de desenvolvimento orientados por investigação
  - Integração de gestão de projetos
  - Documentação e partilha de conhecimento

## Como Executar

Segue estes passos para configurar e executar a aplicação:

1. **Clona o Repositório**:

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

```markdown
2. **Instala as dependências**:
```

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

```markdown
3. **Verifica a instalação do Node.js** (requerido para servidores MCP):
```

```bash
    node --version
    npm --version
    npx --version
    ```

Se o Node.js não estiver instalado, faz o download a partir de [nodejs.org](https://nodejs.org/)

4. **Configura as tuas chaves de API**:
   Cria um ficheiro `.env` no diretório do projeto com as seguintes variáveis:

```env
    OPENAI_API_KEY=your-openai-api-key
    GITHUB_PERSONAL_ACCESS_TOKEN=your-github-token
    PERPLEXITY_API_KEY=your-perplexity-api-key
    ```

```markdown
- Obtém uma chave de API da OpenAI em: https://platform.openai.com/api-keys
- Obtém um Token de Acesso Pessoal do GitHub em: https://github.com/settings/tokens (com os scopes `repo`, `user` e `admin:org`)
- Obtém uma chave de API da Perplexity em: https://www.perplexity.ai/
- Configura os Cabeçalhos MCP da OpenAI de acordo com os requisitos da tua configuração

5. **Executa o Agente Multi-MCP**:
```

```bash
    python multi_mcp_agent.py
    ```

```markdown
6. **Começa a Interagir**:
    - O assistente irá validar as tuas variáveis de ambiente
    - Gerar IDs de utilizador e de sessão únicos
    - Inicializar conexões a todos os servidores MCP
    - Iniciar a interface CLI interativa

## Utilização

1. **Validação do Ambiente**: O assistente verifica automaticamente todas as chaves de API e variáveis de ambiente necessárias
2. **Gestão de Sessões**: Cada sessão recebe IDs de utilizador e de sessão únicos para rastreamento e contexto
3. **Comandos Interativos**: Usa linguagem natural para interagir com serviços integrados:

### Exemplos de Comandos

**Operações GitHub**:
- "Mostra os meus repositórios GitHub recentes"
- "Cria um novo problema no meu repositório de projeto"
- "Procura código Python nos meus repositórios"
- "Reveja os últimos pedidos de pull"

**Pesquisa & Informação**:
- "Procura os últimos desenvolvimentos em IA"
- "Quais são os tópicos em tendência em aprendizagem automática?"
- "Encontra documentação para FastAPI"
- "Pesquisa melhores práticas para microserviços"

**Gestão de Calendário**:
- "Agenda uma reunião para a próxima semana"
- "Mostra os meus compromissos futuros"
- "Encontra horários disponíveis para uma reunião de 2 horas"

**Fluxos de Trabalho Multiplataforma**:
- "Cria um problema no GitHub e agenda uma reunião de acompanhamento"
- "Pesquisa um tópico e cria um documento resumo"
- "Encontra repositórios em tendência e adiciona-os à minha lista de observação"

4. **Controlo de Sessão**: Escreve 'exit', 'quit' ou 'bye' para terminar a sessão

## Arquitetura

O Agente Multi-MCP utiliza:
- **Agno Framework**: Para orquestração de agentes e gestão de ferramentas
- **OpenAI GPT-4o**: Como o modelo de linguagem central
- **Servidores MCP**: Para integrações de serviços externos
- **Arquitetura Assíncrona**: Para operações concorrentes eficientes
- **Sistema de Memória**: Para retenção de contexto e histórico de conversação

## Nota

O assistente conecta-se a múltiplos servidores MCP utilizando pacotes Node.js. Assegura-te de que tens uma conexão de internet estável e chaves de API válidas para todos os serviços. As capacidades de encadeamento de ferramentas permitem fluxos de trabalho complexos que abrangem múltiplas plataformas, tornando-o um poderoso multiplicador de produtividade para desenvolvedores e profissionais.
```

## 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/multi-mcp-agent