Multi Chat MCP Server (Google Chat)

Servidor Multi-Chat MCP (Google Chat Incluído)

---

🎯 O que é o Google Chat MCP Server?

O Google Chat MCP Server é um servidor Model Control Protocol (MCP) de código aberto, pronto para produção, projetado para integração do Google Chat com assistentes de IA. Construído com uma arquitetura extensível de múltiplos provedores, este projeto fornece uma base robusta para integrar assistentes de IA com plataformas de chat de equipe.

🏢 Projetado para Segurança e Privacidade Organizacional

Nota de Segurança Importante: Esta ferramenta é projetada apenas para uso local e organizacional. Recomendamos fortemente o uso com instâncias de LLM locais fornecidas pela organização ou seu Modelo de Agente LLM instalado localmente, em vez de modelos de LLM baseados em nuvem, para manter controle total sobre os dados e comunicações de chat da sua equipe.

Por que implantação local/on-premises:

• Privacidade de Dados: Mantenha conversas confidenciais da equipe dentro da sua organização
• Conformidade de Segurança: Atenda aos requisitos de segurança e conformidade empresarial
• Controle Total: Mantenha supervisão completa do fluxo de dados e acesso
• Políticas Personalizadas: Implemente medidas de segurança específicas da organização

Embora qualquer pessoa possa adaptar esta ferramenta para seus casos de uso específicos, ela foi projetada com a segurança empresarial como prioridade.

Status Atual da Implementação

• ✅ Provedor Google Chat - Pronto para Produção com cobertura abrangente da API
• 🔄 Provedor Slack - Planejado (contribuições bem-vindas)
• 📝 Provedor Microsoft Teams - Planejado (contribuições bem-vindas)

Capacidade Principal: Todos os provedores podem ser executados simultaneamente com uma interface unificada, permitindo que seu assistente de IA trabalhe perfeitamente em várias plataformas de chat ao mesmo tempo. Saiba mais sobre este recurso poderoso.

🧭 A História Por Trás Deste Projeto

Vemos até servidores MCP de código aberto para Google Chat — mas não temos certeza sobre Microsoft Teams ou Slack, oficialmente ou em código aberto. No entanto, mesmo os que existem ficam aquém na aplicabilidade no mundo real. Eles oferecem funcionalidades limitadas que não conseguem lidar com fluxos de trabalho de contexto completo como este projeto demonstra.

Este framework MCP de múltiplos provedores nasceu de uma frustração real vivida por equipes de desenvolvimento que tentavam aproveitar assistentes de IA em seus fluxos de trabalho diários.

---

O Problema Original

Imagine este cenário: Você está depurando um problema complexo, seu assistente de IA sugere uma solução, mas você precisa verificar se seus colegas encontraram algo semelhante. Você muda para o Google Chat, rola por centenas de mensagens, copia e cola logs de erro, espera por respostas e depois transmite manualmente a solução de volta ao seu assistente de IA.

Essa troca constante de contexto estava quebrando o fluxo do desenvolvimento produtivo assistido por IA.

---

O Ponto de Ruptura

Durante um incidente crítico de produção, um desenvolvedor passou 30 minutos transportando manualmente informações entre o Claude (via Cursor) e o espaço do Google Chat da equipe. A IA tinha o conhecimento técnico para ajudar. A equipe tinha a experiência contextual. Mas não havia ponte conectando essas duas fontes de conhecimento.

Foi quando percebemos:

Os assistentes de IA precisam ser participantes da colaboração em equipe — não ferramentas isoladas.

Nossa Solução:

• Integração Perfeita: Assistentes de IA se tornam participantes ativos no chat da equipe
• Consciência Contextual: A IA pode pesquisar o histórico da equipe em busca de problemas e soluções semelhantes
• Resolução Colaborativa de Problemas: A IA pode compartilhar problemas com a equipe e implementar suas sugestões
• Ponte de Conhecimento: Conecte o conhecimento técnico da IA com o conhecimento experiencial da equipe

🎯 Projetado para Extensibilidade do Desenvolvedor

🏗️ Arquitetura Modular de Provedores

Cada plataforma de chat é implementada como um módulo independente:

src/providers/
├── google_chat/     # ✅ Complete implementation
├── slack/           # 📋 Framework ready for implementation  
└── teams/           # 📋 Framework ready for implementation

👥 Para Quem é Este Projeto?

Este projeto é projetado para dois públicos principais:

🛠️ 1. Desenvolvedores dentro de organizações

Se você é um desenvolvedor trabalhando em uma equipe que usa Google Chat e deseja integrar seus IDEs de IA (como Cursor, CodeWhisperer ou Copilot Chat) com conversas da equipe — este cliente MCP economizará horas. Chega de copiar logs manualmente, verificar contexto ou esperar que alguém veja sua pergunta. Seu agente de IA agora pode diretamente:

• Pesquisar seu histórico de chat em busca de discussões passadas relevantes
• Compartilhar trechos de código ou logs de erro automaticamente
• Receber respostas e convertê-las em correções acionáveis
• Resumir atividades contínuas da equipe
• Buscar configurações/scripts ausentes em espaços compartilhados

💡 2. Contribuidores de código aberto e construtores de plataformas de IA

Se você está construindo ferramentas com IA, integrações de IDE ou assistentes internos — este é seu ponto de partida para uma arquitetura MCP de múltiplos provedores. Você pode bifurcar este projeto para:

• Estender o suporte para Slack, Microsoft Teams ou plataformas de mensagens personalizadas
• Construir seus próprios fluxos de trabalho de IA personalizados sobre o MCP

🧩 Google Chat MCP Server – Demonstração de Uso no Mundo Real

Estes exemplos mostram como um assistente de IA, alimentado por este servidor MCP, evolui de uma ferramenta passiva para um colaborador ativo — depurando problemas, coordenando equipes, sincronizando scripts e desbloqueando desenvolvedores proativamente.

---

🛠️ Configuração e Inicialização da Ferramenta

O Cenário: Conectando o cliente MCP ao Google Chat.

O que está Acontecendo: O assistente de IA recebe acesso a todas as ferramentas do Google Chat (ex.: enviar, pesquisar, resumir, anexar, responder).

Por que isso Importa: O assistente agora pode agir dentro do Google Chat, não apenas observar.

---

🧯 Depuração e Resolução (Exemplo com Docker)

O que está Acontecendo: Um desenvolvedor pede à IA para compartilhar logs de erro do Docker no chat, solicitando ajuda da equipe em tempo real.

Próximo Passo: Um colega responde com uma correção no Dockerfile (COPY requirements.txt .).

Momento de Automação: O assistente de IA edita o Dockerfile de acordo com o conselho — sem esforço manual.

Conclusão: Ele verifica a alteração, confirma que requirements.txt existe — e o erro deve estar resolvido.

---

📦 Sincronização de Dependências e Scripts

Cenário: Pedi à minha equipe que compartilhasse um requirements.txt funcional.

Resposta: Um dos meus colegas compartilhou seu requirements.txt funcional.

Ponto de Vista do Desenvolvedor: A IA revisou o tópico e, com base na minha instrução, atualizou meu requirements.txt local com o que foi compartilhado

---

Cenário: Você pede à sua equipe um script aws-setup.sh compartilhado.

Ponto de Vista do Desenvolvedor: A IA revisou o tópico e, com base na minha instrução, compara o script da equipe com sua versão local — garantindo que você esteja sincronizado.

---

👀 Coordenação de Equipe e Atualização

Contexto: Você esteve ausente. O que há de novo?

Resposta da IA: O assistente resume as principais atividades no seu espaço: perguntas, PRs, arquivos compartilhados, bloqueios.

Perdeu uma menção? A IA verifica todas as menções e traz à tona conversas nas quais você foi marcado.

---

🔍 Resolução de Problemas com IA a partir do Contexto do Chat da Equipe

O Cenário: Um desenvolvedor pede explicitamente ao assistente de IA para ajudar a resolver preocupações em aberto mencionadas pela equipe no espaço de chat.

O que está Acontecendo: A IA examina mensagens recentes do chat, identifica perguntas técnicas, arquivos ausentes e possíveis bloqueios relacionados ao projeto, e se prepara para ajudar.

Perspectiva do Desenvolvedor: O agente não é apenas reativo — ele entende o contexto da equipe e pode pesquisar problemas não resolvidos quando solicitado.

Exemplo de Caso de Uso: Um colega mencionou que não conseguia encontrar ReviewForm.js.

Resposta da IA: O agente pesquisa o repositório local, encontra o caminho correto e responde diretamente no tópico do chat.

Por que isso Importa: Em vez de esperar que alguém responda, o assistente de IA desbloqueia colegas em tempo real com respostas precisas e conscientes do repositório — tornando a integração e a colaboração mais rápidas e suaves.

🚀 Início Rápido: Configuração do Google Chat MCP Server

Pré-requisitos

• Python 3.9+
• Gerenciador de Pacotes UV (recomendado)
• Projeto Google Cloud com a API do Google Chat habilitada
• Cliente MCP (Claude Desktop, Cursor ou outro assistente de IA compatível com MCP)

Passo 1: Instalação

# Clone the repository
git clone https://github.com/siva010928/multi-chat-mcp-server.git
cd multi-chat-mcp-server

# Install dependencies
uv venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
uv pip install -r requirements.txt

Passo 2: Configuração de Autenticação do Google Chat

# Set up Google Chat API credentials
# 1. Create Google Cloud project
# 2. Enable Google Chat API
# 3. In the Google Chat API dashboard, open the **Configuration** tab and complete the application setup (app name, logo, etc.). *The API will refuse requests until this step is finished.*
# 4. Download credentials.json to src/providers/google_chat/

# Run authentication
python -m src.server --provider google_chat -local-auth

Passo 3: Conecte-se ao Seu Assistente de IA

Para integração Cursor + Claude, consulte nosso guia detalhado de Integração do Google Chat MCP com Cursor.

Para outros clientes MCP, adicione esta configuração:

{
  "mcpServers": {
    "google_chat_mcp": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/multi-chat-mcp-server",
        "run", "-m", "src.server",
        "--provider", "google_chat"
      ]
    }
  }
}

📖 Documentação Detalhada de Configuração

Para instruções abrangentes de configuração, incluindo configuração do Google Cloud, configuração OAuth e solução de problemas, consulte nosso Guia Completo de Configuração do Google Chat MCP - Este guia detalhado de implementação cobre:

• Configuração do projeto no Google Cloud e ativação da API
• Configuração OAuth 2.0 e melhores práticas de segurança
• Fluxo de autenticação passo a passo
• Problemas comuns de configuração e suas soluções

Ferramentas do Google Chat Suportadas (serão ampliadas)

Interaja com o Google Chat usando as ferramentas abaixo. Cada ferramenta inclui seu arquivo de origem e parâmetros.

🧭 Gerenciamento de Espaços

• get_chat_spaces_tool – Listar espaços
• manage_space_members_tool – Adicionar/remover membros
• get_conversation_participants_tool – Obter participantes do espaço
• summarize_conversation_tool – Resumir conversa

💬 Mensagens

• send_message_tool – Enviar uma mensagem
• reply_to_message_thread_tool – Responder em thread
• update_chat_message_tool – Atualizar mensagem
• delete_chat_message_tool – Excluir mensagem

😀 Interações

• add_emoji_reaction_tool – Reagir à mensagem
• get_chat_message_tool – Obter detalhes da mensagem

🔍 Busca e Filtros

• search_messages_tool – Buscar mensagens
• get_my_mentions_tool – Encontrar menções

👤 Informações do Usuário

• get_my_user_info_tool – Seu perfil
• get_user_info_by_id_tool – Usuário por ID
• get_message_with_sender_info_tool – Mensagem com informações do remetente
• list_messages_with_sender_info_tool – Listar mensagens com informações do remetente

📎 Manipulação de Arquivos

• upload_attachment_tool – Enviar anexo
• send_file_message_tool – Enviar conteúdo do arquivo
• send_file_content_tool – Enviar conteúdo formatado do arquivo

📦 Operações em Lote

• batch_send_messages_tool – Enviar múltiplas mensagens

📁 Arquivos de origem localizados em src/providers/google_chat/tools/

Executando Múltiplos Provedores de Chat Simultaneamente

Uma das principais vantagens do Multi Chat MCP Server é a capacidade de executar múltiplos provedores de chat simultaneamente. Cada provedor é executado em sua própria instância de servidor, permitindo que seu assistente de IA interaja com várias plataformas ao mesmo tempo.

Por exemplo, você pode configurar os servidores MCP do Google Chat e do Slack para executar simultaneamente:

{
  "mcpServers": {
    "google_chat": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/multi-chat-mcp-server",
        "run", "-m", "src.server",
        "--provider", "google_chat"
      ]
    },
    "slack": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/multi-chat-mcp-server",
        "run", "-m", "src.server",
        "--provider", "slack"
      ]
    }
  }
}

Com esta configuração, seu assistente de IA pode:

• Acessar ferramentas de todos os provedores configurados simultaneamente
• Executar ações entre plataformas com um único comando
• Realizar operações específicas de plataforma através de provedores nomeados

Cenários Reais Multi-Plataforma

Cenário	Exemplo de Comando para IA	O Que Acontece
Resposta a Incidentes	"Compartilhe este log de erro com nosso canal #on-call do Slack e com a equipe #tech-huddle do Google Chat"	A IA publica o erro em ambas as plataformas simultaneamente, com formatação apropriada para cada uma
Consolidação de Conhecimento	"Encontre todas as discussões sobre o problema de autenticação no Slack #LLMSpace e no Google Chat #LLMTools na última semana"	A IA busca em ambas as plataformas e apresenta um resumo unificado de todas as conversas relevantes
Coordenação Entre Equipes	"Avise à equipe de frontend no Slack e à equipe de backend no Google Chat que estamos adiando o lançamento em 2 dias"	A IA compõe mensagens apropriadas para cada equipe em sua plataforma preferida
Reuniões Diárias Multi-Equipe	"Colete atualizações de status de todas as equipes no Slack e no Google Chat a partir do espaço de standup e resuma-as dos últimos 3 dias."	A IA recupera e consolida informações de ambas as plataformas em um único resumo

Valor Comercial da Integração Multi-Provedor

• Reduza a Troca de Ferramentas: Não há necessidade de os desenvolvedores alternarem constantemente entre plataformas de chat para casos de uso menores, como compartilhar logs de erro, instruções ou respostas
• Contexto Unificado: Seu assistente de IA mantém consciência em todos os canais de comunicação da sua organização

Cada provedor é definido separadamente em provider-config.yaml, permitindo que você estenda o suporte para qualquer plataforma de chat enquanto mantém uma interface unificada para seu assistente de IA.

🔥 Fluxos de Trabalho Reais Habilitados

A demonstração acima apresenta estes fluxos práticos de colaboração em equipe:

Resolução Colaborativa de Problemas

• Compartilhamento e Resolução de Erros: A IA compartilha erros de desenvolvedores com a equipe, recebe orientação de especialistas e implementa soluções
• Transferência de Conhecimento: A experiência da equipe é capturada e aplicada através da assistência da IA
• Detecção Proativa de Problemas: A IA monitora o chat da equipe em busca de preocupações emergentes e oferece assistência

Gerenciamento Inteligente de Recursos

• Troca de Scripts: Solicite e receba scripts da equipe com comparação automática com versões locais
• Sincronização de Requisitos: Extraia e mescle arquivos de requisitos das discussões da equipe
• Compartilhamento Sensível ao Contexto: A IA determina o compartilhamento ideal de arquivos com base nas necessidades da equipe

Comunicação Aprimorada da Equipe

• Rastreamento de Menções: Monitoramento abrangente e resposta a menções da equipe
• Resumos de Atividade: Atualizações geradas por IA sobre o progresso da equipe e bloqueios
• Busca Semântica: Encontre discussões conceitualmente relacionadas nos espaços da equipe

📁 Arquitetura do Projeto

multi-chat-mcp-server/
├── src/
│   ├── providers/
│   │   ├── google_chat/           # ✅Production-Ready Google Chat MCP
│   │   │   ├── api/               # Google Chat API implementation
│   │   │   ├── tools/             # MCP tools for Google Chat
│   │   │   ├── utils/             # Utilities and helpers
│   │   │   ├── README.md          # Setup guide
│   │   │   └── CURSOR_INTEGRATION.md  # Cursor integration
│   │   ├── slack/                 # 📋 Ready for implementation
│   │   └── teams/                 # 📋 Ready for implementation
│   ├── mcp_core/                  # Core MCP functionality
│   └── server.py                  # Multi-provider MCP server
├── provider-config.yaml           # Provider configurations
└── google_chat_mcp_client_demo_images/  # Demo screenshots

Configuração do Provedor

providers:
  google_chat:
    name: "Google Chat MCP Server"
    description: "Production-ready Google Chat MCP integration"
    token_path: "src/providers/google_chat/token.json"
    credentials_path: "src/providers/google_chat/credentials.json"
    callback_url: "http://localhost:8000/auth/callback"

🔮 Roadmap e Contribuição

Status Atual da Implementação

• ✅ Provedor Google Chat - Pronto para produção com recursos abrangentes
• 📋 Provedor Slack - Framework pronto, implementação necessária
• 📋 Provedor Teams - Framework pronto, implementação necessária

Como Contribuir

Aceitamos contribuições para estender este framework com provedores adicionais:

1. Escolha um Provedor: Slack, Teams ou qualquer outra plataforma de chat
2. Siga a Arquitetura: Use src/providers/google_chat/ como referência
3. Implemente os Recursos Principais: Mensagens, busca, gerenciamento de usuários
4. Adicione Ferramentas Específicas do Provedor: Aproveite as capacidades exclusivas da plataforma
5. Envie um Pull Request: Ajudaremos na revisão e integração

Começando com Contribuições:

• 📖 Guia de Desenvolvimento de Provedores - Detalhes técnicos de implementação
• 🔗 GitHub Issues - Encontre tarefas ou relate bugs
• 💬 GitHub Discussions - Solicitações de recursos e ideias

📚 Documentação

Recursos Essenciais

• 📖 Guia Completo de Configuração do Google Chat MCP - Guia detalhado de implementação
• 🔗 Integração Google Chat MCP + Cursor - Configuração passo a passo do Cursor
• 🛠️ Guia de Desenvolvimento de Provedores - Estenda a funcionalidade
• ⚖️ Acordo de Licença do Contribuidor - Diretrizes de contribuição

🔍 Solução de Problemas

Problemas Comuns do Google Chat

Problemas de Autenticação

# Re-authenticate Google Chat
python -m src.server --provider google_chat -local-auth

Problemas de Registro de Ferramentas

• Verifique se as ferramentas aparecem no seu assistente de IA
• Verifique a configuração do provedor em provider-config.yaml
• Garanta que todos os escopos da API do Google Chat sejam concedidos

Problemas de Conexão

• Confirme se a API do Google Chat está ativada no Google Cloud Console
• Verifique a localização do arquivo credentials.json
• Verifique a conectividade de rede e as configurações de firewall

🏆 Por Que Escolher Este Servidor MCP?

✅ Integração do Google Chat Testada em Batalha

• Cobertura abrangente da API além de mensagens básicas
• Fluxos de trabalho reais testados em ambientes de desenvolvimento
• Pronto para produção com tratamento adequado de erros e autenticação

✅ Arquitetura Amigável para Desenvolvedores

• Criado por desenvolvedores para fluxos de trabalho reais de desenvolvimento
• Design modular facilita a compreensão e extensão
• Bem documentado com exemplos práticos

✅ Framework Extensível pela Comunidade

• Código aberto com desenvolvimento transparente
• Arquitetura e documentação amigáveis para contribuidores
• Pronto para múltiplos provedores para diversas necessidades de negócio

📞 Suporte e Comunidade

Obter Ajuda

• 🐛 Relatórios de Bugs: GitHub Issues
• 💡 Solicitações de Recursos: GitHub Discussions
• 🛠️ Dúvidas de Desenvolvimento: Abra uma issue com detalhes técnicos

Contribuindo

Aceitamos contribuições para expandir este framework multi-provedor:

1. Faça um fork do repositório
2. Crie um branch de recurso para seu provedor ou melhoria
3. Siga os padrões de arquitetura existentes
4. Envie um pull request
5. Assine nosso Acordo de Licença do Contribuidor

📄 Licença e Direitos Autorais

Licença de Código Aberto

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

Aviso de Direitos Autorais

Copyright (c) 2025 Sivaprakash Kumar. Todos os direitos reservados.

Embora este seja um projeto de código aberto que aceita contribuições, todos os direitos autorais e de propriedade permanecem com Sivaprakash Kumar. Consulte COPYRIGHT para obter detalhes.

---