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:

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

2. Instala as dependências:

    pip install -r requirements.txt
    ```


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

node --version

npm --version

npx --version

```

Se o Node.js não estiver instalado, faz o download a partir de nodejs.org

4. Configura as tuas chaves de API:

Cria um ficheiro .env no diretório do projeto com as seguintes variáveis:

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


- 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**:

python multi_mcp_agent.py

```

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.