Multi Chat MCP Server (Google Chat)

Servidor Multi-Chat MCP (Incluye Google Chat)

---

🎯 ¿Qué es el Servidor MCP de Google Chat?

El Servidor MCP de Google Chat es un servidor de Protocolo de Control de Modelos (MCP) de código abierto y listo para producción, diseñado para la integración de Google Chat con asistentes de IA. Construido con una arquitectura multi-proveedor extensible, este proyecto proporciona una base sólida para integrar asistentes de IA con plataformas de chat de equipo.

🏢 Diseñado para Seguridad y Privacidad Organizacional

Nota de Seguridad Importante: Esta herramienta está diseñada únicamente para uso local y organizacional. Recomendamos encarecidamente usarla con instancias de LLM locales proporcionadas por la organización o tu modelo de agente LLM instalado localmente, en lugar de modelos de LLM basados en la nube, para mantener un control total sobre los datos y comunicaciones de chat de tu equipo.

Por qué implementación local/on-premises:

• Privacidad de Datos: Mantén conversaciones sensibles del equipo dentro de tu organización
• Cumplimiento de Seguridad: Cumple con los requisitos de seguridad y cumplimiento empresarial
• Control Total: Mantén una supervisión completa del flujo de datos y el acceso
• Políticas Personalizadas: Implementa medidas de seguridad específicas de la organización

Aunque cualquiera puede adaptar esta herramienta para sus casos de uso particulares, está diseñada con la seguridad empresarial como prioridad.

Estado de Implementación Actual

• ✅ Proveedor de Google Chat - Listo para Producción con cobertura integral de API
• 🔄 Proveedor de Slack - Planificado (se aceptan contribuciones)
• 📝 Proveedor de Microsoft Teams - Planificado (se aceptan contribuciones)

Capacidad Clave: Todos los proveedores pueden ejecutarse simultáneamente con una interfaz unificada, lo que permite a tu asistente de IA trabajar sin problemas en múltiples plataformas de chat a la vez. Aprende más sobre esta potente característica.

🧭 La Historia Detrás de Este Proyecto

Incluso vemos servidores MCP de código abierto para Google Chat, pero no estamos seguros sobre Microsoft Teams o Slack, ni oficialmente ni en código abierto. Sin embargo, incluso los que existen se quedan cortos en aplicabilidad en el mundo real. Ofrecen funcionalidades limitadas que no pueden manejar flujos de trabajo de contexto completo como demuestra este proyecto.

Este framework MCP multi-proveedor nació de una frustración real experimentada por equipos de desarrollo que intentaban aprovechar los asistentes de IA en sus flujos de trabajo diarios.

---

El Problema Original

Imagina este escenario: Estás depurando un problema complejo, tu asistente de IA sugiere una solución, pero necesitas verificar si tus compañeros de equipo han encontrado algo similar. Cambias a Google Chat, te desplazas por cientos de mensajes, copias y pegas registros de errores, esperas respuestas y luego transmites manualmente la solución de vuelta a tu asistente de IA.

Este cambio constante de contexto estaba rompiendo el flujo del desarrollo productivo asistido por IA.

---

El Punto de Quiebre

Durante un incidente crítico de producción, un desarrollador pasó 30 minutos transfiriendo información manualmente entre Claude (a través de Cursor) y el espacio de Google Chat del equipo. La IA tenía el conocimiento técnico para ayudar. El equipo tenía la experiencia contextual. Pero no había un puente que conectara estas dos fuentes de conocimiento.

Fue entonces cuando nos dimos cuenta:

Los asistentes de IA necesitan ser participantes en la colaboración del equipo, no herramientas aisladas.

Nuestra Solución:

• Integración Perfecta: Los asistentes de IA se convierten en participantes activos en el chat del equipo
• Conciencia Contextual: La IA puede buscar en el historial del equipo problemas y soluciones similares
• Resolución Colaborativa de Problemas: La IA puede compartir problemas con el equipo e implementar sus sugerencias
• Puente de Conocimiento: Conecta el conocimiento técnico de la IA con el conocimiento experiencial del equipo

🎯 Diseñado para la Extensibilidad del Desarrollador

🏗️ Arquitectura Modular de Proveedores

Cada plataforma de chat se implementa como un módulo independiente:

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

👥 ¿Para Quién Es Esto?

Este proyecto está diseñado para dos audiencias principales:

🛠️ 1. Desarrolladores dentro de organizaciones

Si eres un desarrollador que trabaja en un equipo que usa Google Chat y buscas integrar tus IDEs de IA (como Cursor, CodeWhisperer o Copilot Chat) con conversaciones de equipo, este cliente MCP te ahorrará horas. No más copiar registros manualmente, verificar contexto o esperar a que alguien vea tu pregunta. Tu agente de IA ahora puede directamente:

• Buscar en tu historial de chat discusiones pasadas relevantes
• Compartir fragmentos de código o registros de errores automáticamente
• Recibir respuestas y convertirlas en correcciones accionables
• Resumir actividades continuas del equipo
• Obtener configuraciones/scripts faltantes de espacios compartidos

💡 2. Contribuyentes de código abierto y constructores de plataformas de IA

Si estás construyendo herramientas impulsadas por IA, integraciones de IDE o asistentes internos, este es tu punto de partida para una arquitectura MCP multi-proveedor. Puedes bifurcar este proyecto para:

• Ampliar el soporte para Slack, Microsoft Teams o plataformas de mensajería personalizadas
• Construir tus propios flujos de trabajo de IA personalizados sobre MCP

🧩 Servidor MCP de Google Chat – Demostración de Uso en el Mundo Real

Estos recorridos muestran cómo un asistente de IA, impulsado por este servidor MCP, evoluciona de una herramienta pasiva a un colaborador activo: depurando problemas, coordinando equipos, sincronizando scripts y desbloqueando proactivamente a los desarrolladores.

---

🛠️ Configuración e Inicialización de Herramientas

El Escenario: Conectando el cliente MCP a Google Chat.

Qué Está Sucediendo: Al asistente de IA se le concede acceso a todas las herramientas de Google Chat (por ejemplo, enviar, buscar, resumir, adjuntar, responder).

Por Qué Importa: El asistente ahora puede actuar dentro de Google Chat, no solo observar.

---

🧯 Depuración y Resolución (Ejemplo con Docker)

Qué Está Sucediendo: Un desarrollador le pide a la IA que comparta registros de errores de Docker en el chat, lo que provoca ayuda del equipo en tiempo real.

Siguiente Paso: Un compañero de equipo responde con una corrección de Dockerfile (COPY requirements.txt .).

Momento de Automatización: El asistente de IA edita el Dockerfile según el consejo, sin esfuerzo manual.

Conclusión: Verifica el cambio, confirma que requirements.txt existe, y el error debería estar resuelto.

---

📦 Sincronización de Dependencias y Scripts

Escenario: He solicitado a mi equipo que comparta un requirements.txt funcional.

Respuesta: Uno de mis compañeros compartió su requirements.txt funcional.

Punto de Vista del Desarrollador: La IA revisó el hilo y, según mi instrucción, actualizó mi requirements.txt local con el que se compartió.

---

Escenario: Le pides a tu equipo un script aws-setup.sh compartido.

Punto de Vista del Desarrollador: La IA revisó el hilo y, según mi instrucción, compara el script del equipo con tu versión local, asegurando que estés sincronizado.

---

👀 Coordinación del Equipo y Puesta al Día

Contexto: Has estado ausente. ¿Qué hay de nuevo?

Respuesta de la IA: El asistente resume la actividad clave en tu espacio: preguntas, PRs, archivos compartidos, bloqueos.

¿Te perdiste una mención? La IA escanea todas las menciones y muestra las conversaciones en las que fuiste etiquetado.

---

🔍 Resolución de Problemas Impulsada por IA desde el Contexto del Chat del Equipo

El Escenario: Un desarrollador le pide explícitamente al asistente de IA que ayude a resolver las inquietudes abiertas mencionadas por el equipo en el espacio de chat.

Qué Está Sucediendo: La IA escanea los mensajes recientes del chat, identifica preguntas técnicas, archivos faltantes y posibles bloqueos relacionados con el proyecto, y se prepara para ayudar.

Perspectiva del Desarrollador: El agente no es solo reactivo: entiende el contexto del equipo y puede buscar problemas no resueltos cuando se le solicita.

Caso de Uso de Ejemplo: Un compañero de equipo mencionó que no podía encontrar ReviewForm.js.

Respuesta de la IA: El agente busca en el repositorio local, encuentra la ruta correcta y responde directamente en el hilo del chat.

Por Qué Importa: En lugar de esperar a que alguien responda, el asistente de IA desbloquea a los compañeros de equipo en tiempo real con respuestas precisas y conscientes del repositorio, haciendo que la incorporación y la colaboración sean más rápidas y fluidas.

🚀 Inicio Rápido: Configuración del Servidor MCP de Google Chat

Requisitos Previos

• Python 3.9+
• Administrador de Paquetes UV (recomendado)
• Proyecto de Google Cloud con la API de Google Chat habilitada
• Cliente MCP (Claude Desktop, Cursor u otro asistente de IA compatible con MCP)

Paso 1: Instalación

# 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

Paso 2: Configuración de Autenticación de 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

Paso 3: Conéctate a Tu Asistente de IA

Para la integración Cursor + Claude, consulta nuestra guía detallada de Integración de Google Chat MCP con Cursor.

Para otros clientes MCP, agrega esta configuración:

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

📖 Documentación Detallada de Configuración

Para obtener instrucciones completas de configuración, incluida la configuración de Google Cloud, la configuración de OAuth y la resolución de problemas, consulta nuestra Guía completa de configuración de Google Chat MCP - Esta guía de implementación detallada cubre:

• Configuración del proyecto de Google Cloud y habilitación de API
• Configuración de OAuth 2.0 y mejores prácticas de seguridad
• Flujo de autenticación paso a paso
• Problemas comunes de configuración y sus soluciones

Herramientas de Google Chat compatibles (se ampliarán)

Interactúa con Google Chat usando las herramientas a continuación. Cada herramienta incluye su archivo fuente y parámetros.

🧭 Gestión de espacios

• get_chat_spaces_tool – Listar espacios
• manage_space_members_tool – Agregar/eliminar miembros
• get_conversation_participants_tool – Obtener participantes del espacio
• summarize_conversation_tool – Resumir conversación

💬 Mensajería

• send_message_tool – Enviar un mensaje
• reply_to_message_thread_tool – Responder en hilo
• update_chat_message_tool – Actualizar mensaje
• delete_chat_message_tool – Eliminar mensaje

😀 Interacciones

• add_emoji_reaction_tool – Reaccionar al mensaje
• get_chat_message_tool – Obtener detalles del mensaje

🔍 Búsqueda y filtros

• search_messages_tool – Buscar mensajes
• get_my_mentions_tool – Encontrar menciones

👤 Información de usuario

• get_my_user_info_tool – Tu perfil
• get_user_info_by_id_tool – Usuario por ID
• get_message_with_sender_info_tool – Mensaje con información del remitente
• list_messages_with_sender_info_tool – Listar mensajes con información del remitente

📎 Manejo de archivos

• upload_attachment_tool – Subir adjunto
• send_file_message_tool – Enviar contenido de archivo
• send_file_content_tool – Enviar contenido de archivo formateado

📦 Operaciones por lotes

• batch_send_messages_tool – Enviar múltiples mensajes

📁 Archivos fuente ubicados en src/providers/google_chat/tools/

Ejecución de múltiples proveedores de chat simultáneamente

Una de las principales ventajas de Multi Chat MCP Server es la capacidad de ejecutar múltiples proveedores de chat simultáneamente. Cada proveedor se ejecuta en su propia instancia de servidor, lo que permite que tu asistente de IA interactúe con múltiples plataformas a la vez.

Por ejemplo, puedes configurar tanto los servidores MCP de Google Chat como los de Slack para que se ejecuten simultáneamente:

{
  "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"
      ]
    }
  }
}

Con esta configuración, tu asistente de IA puede:

• Acceder a herramientas de todos los proveedores configurados simultáneamente
• Ejecutar acciones multiplataforma con un solo comando
• Realizar operaciones específicas de la plataforma a través de proveedores nombrados

Escenarios multiplataforma del mundo real

Escenario	Comando de ejemplo para IA	Qué sucede
Respuesta a incidentes	"Comparte este registro de errores con nuestro canal de Slack #on-call y el equipo de Google Chat #tech-huddle"	La IA publica el error en ambas plataformas simultáneamente, con el formato apropiado para cada una
Consolidación de conocimiento	"Encuentra todas las discusiones sobre el problema de autenticación en Slack #LLMSpace y Google Chat #LLMTools de la última semana"	La IA busca en ambas plataformas y presenta un resumen unificado de todas las conversaciones relevantes
Coordinación entre equipos	"Haz saber al equipo de frontend en Slack y al equipo de backend en Google Chat que retrasamos el lanzamiento 2 días"	La IA redacta mensajes apropiados para cada equipo en su plataforma preferida
Reuniones diarias de múltiples equipos	"Recopila actualizaciones de estado de todos los equipos en Slack y Google Chat desde el espacio de reunión diaria y resúmelas de los últimos 3 días."	La IA recupera y consolida información de ambas plataformas en un solo resumen

Valor comercial de la integración multiproveedor

• Reducir el cambio de herramientas: No es necesario que los desarrolladores cambien constantemente entre plataformas de chat para casos de uso más pequeños, como compartir registros de errores, instrucciones o respuestas
• Contexto unificado: Tu asistente de IA mantiene el conocimiento en todos los canales de comunicación de tu organización

Cada proveedor se define por separado en provider-config.yaml, lo que te permite ampliar el soporte para cualquier plataforma de chat mientras mantienes una interfaz unificada para tu asistente de IA.

🔥 Flujos de trabajo del mundo real habilitados

La demostración anterior muestra estos flujos de trabajo prácticos de colaboración en equipo:

Resolución colaborativa de problemas

• Compartir y resolver errores: La IA comparte errores de desarrolladores con el equipo, recibe orientación experta e implementa soluciones
• Transferencia de conocimiento: La experiencia del equipo se captura y se aplica mediante la asistencia de IA
• Detección proactiva de problemas: La IA monitorea el chat del equipo para detectar inquietudes emergentes y ofrece asistencia

Gestión inteligente de recursos

• Intercambio de scripts: Solicita y recibe scripts del equipo con comparación automática con versiones locales
• Sincronización de requisitos: Extrae y combina archivos de requisitos de discusiones del equipo
• Compartir con conciencia del contexto: La IA determina el intercambio de archivos óptimo según las necesidades del equipo

Comunicación mejorada del equipo

• Seguimiento de menciones: Monitoreo integral y respuesta a menciones del equipo
• Resúmenes de actividad: Actualizaciones generadas por IA sobre el progreso y los bloqueos del equipo
• Búsqueda semántica: Encuentra discusiones conceptualmente relacionadas en los espacios del equipo

📁 Arquitectura del proyecto

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

Configuración del proveedor

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"

🔮 Hoja de ruta y contribuciones

Estado actual de implementación

• ✅ Proveedor de Google Chat - Listo para producción con características completas
• 📋 Proveedor de Slack - Marco listo, implementación necesaria
• 📋 Proveedor de Teams - Marco listo, implementación necesaria

Cómo contribuir

Damos la bienvenida a contribuciones para ampliar este marco con proveedores adicionales:

1. Elige un proveedor: Slack, Teams o cualquier otra plataforma de chat
2. Sigue la arquitectura: Usa src/providers/google_chat/ como referencia
3. Implementa las características principales: Mensajes, búsqueda, gestión de usuarios
4. Agrega herramientas específicas del proveedor: Aprovecha las capacidades únicas de la plataforma
5. Envía una solicitud de extracción: Te ayudaremos a revisar e integrar

Cómo comenzar con las contribuciones:

• 📖 Guía de desarrollo de proveedores - Detalles técnicos de implementación
• 🔗 Problemas de GitHub - Encuentra tareas o reporta errores
• 💬 Discusiones de GitHub - Solicitudes de funciones e ideas

📚 Documentación

Recursos esenciales

• 📖 Guía completa de configuración de Google Chat MCP - Guía de implementación detallada
• 🔗 Integración de Google Chat MCP + Cursor - Configuración paso a paso de Cursor
• 🛠️ Guía de desarrollo de proveedores - Amplía la funcionalidad
• ⚖️ Acuerdo de licencia del contribuyente - Directrices de contribución

🔍 Solución de problemas

Problemas comunes de Google Chat

Problemas de autenticación

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

Problemas de registro de herramientas

• Verifica que las herramientas aparezcan en tu asistente de IA
• Revisa la configuración del proveedor en provider-config.yaml
• Asegúrate de que todos los alcances de la API de Google Chat estén otorgados

Problemas de conexión

• Confirma que la API de Google Chat esté habilitada en la consola de Google Cloud
• Verifica la ubicación del archivo credentials.json
• Revisa la conectividad de red y la configuración del firewall

🏆 ¿Por qué elegir este servidor MCP?

✅ Integración de Google Chat probada en batalla

• Cobertura integral de API más allá de la mensajería básica
• Flujos de trabajo del mundo real probados en entornos de desarrollo
• Listo para producción con manejo de errores y autenticación adecuados

✅ Arquitectura amigable para desarrolladores

• Creado por desarrolladores para flujos de trabajo de desarrollo reales
• Diseño modular facilita la comprensión y la extensión
• Bien documentado con ejemplos prácticos

✅ Marco extensible por la comunidad

• Código abierto con desarrollo transparente
• Arquitectura y documentación amigables para contribuyentes
• Listo para múltiples proveedores para diversas necesidades empresariales

📞 Soporte y comunidad

Obtener ayuda

• 🐛 Informes de errores: Problemas de GitHub
• 💡 Solicitudes de funciones: Discusiones de GitHub
• 🛠️ Preguntas de desarrollo: Abre un problema con detalles técnicos

Contribuciones

Damos la bienvenida a contribuciones para ampliar este marco multiproveedor:

1. Haz un fork del repositorio
2. Crea una rama de características para tu proveedor o mejora
3. Sigue los patrones de arquitectura existentes
4. Envía una solicitud de extracción
5. Firma nuestro Acuerdo de licencia del contribuyente

📄 Licencia y derechos de autor

Licencia de código abierto

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENCIA para más detalles.

Aviso de derechos de autor

Derechos de autor (c) 2025 Sivaprakash Kumar. Todos los derechos reservados.

Si bien este es un proyecto de código abierto que da la bienvenida a contribuciones, todos los derechos de autor y propiedad permanecen con Sivaprakash Kumar. Consulta DERECHOS DE AUTOR para más detalles.

---