Google Chat MCP Server

Introducción

Este proyecto proporciona una integración de Google Chat para servidores MCP (Protocolo de Control de Modelos) escritos en Python con FastMCP. Permite acceder e interactuar con espacios y mensajes de Google Chat mediante herramientas MCP.

Estructura

El proyecto consta de dos componentes principales:

1. Servidor MCP con herramientas de Google Chat : proporciona herramientas para interactuar con Google Chat a través del Protocolo de control de modelos.
   • Escrito por FastMCP
   • server.py : Implementación del servidor MCP principal con herramientas de Google Chat
   • google_chat.py : Integración de la API de Google Chat y gestión de la autenticación
2. Servidor de autenticación : componente independiente para la autenticación de cuentas de Google
   • Escrito por FastAPI
   • Maneja el flujo OAuth2 con Google
   • Almacena y administra tokens de acceso
   • Se puede ejecutar de forma independiente o como parte del servidor MCP
   • server_auth.py : Implementación del servidor de autenticación

El flujo de autenticación te permite obtener y actualizar los tokens de la API de Google, que luego utilizan las herramientas de MCP para acceder a los datos de Google Chat (tus espacios y mensajes).

Características

• Autenticación OAuth2 con la API de Google Chat
• Lista de espacios de chat de Google disponibles
• Recuperar mensajes de espacios específicos con filtrado de fechas
• Servidor de autenticación local para una fácil configuración

Requisitos

• Python 3.8+
• Proyecto de Google Cloud con API de chat habilitada
• Credenciales OAuth2 de Google Cloud Console

¿Cómo utilizarlo?

Preparar el inicio de sesión de Google OAuth

1. Clonar este proyecto
   git clone https://github.com/chy168/google-chat-mcp-server.git cd google-chat-mcp-server
2. Preparar un proyecto de Google Cloud (GCP)
3. Google Cloud Console ( https://console.cloud.google.com/auth/overview?project=\ <SU_NOMBRE_DE_PROYECTO>)
4. Plataforma de autenticación de Google > Clientes > (+) Crear cliente > Referencia de la aplicación web: https://developers.google.com/identity/protocols/oauth2/?hl=es Orígenes de JavaScript autorizados: http://localhost:8000 URI de redireccionamiento autorizados: http://localhost:8000/auth/callback
5. Después de crear un cliente OAuth 2.0, descargue los secretos del cliente como archivo .json . Guárdelos como credentials.json en el nivel superior del proyecto.

Ejecute el servidor de autenticación y obtenga su token de acceso de Google (inicie sesión solo en Google, todavía no en el servidor MCP)

• Abra el navegador en http://localhost:8000/auth
• ¡Inicia sesión!
• Después de iniciar sesión, su token de acceso se guardará como token.json

Configuración de MCP (mcp.json)

Herramientas

El servidor MCP proporciona las siguientes herramientas:

Herramientas de chat de Google

• get_chat_spaces() - Enumera todos los espacios de Google Chat a los que el bot tiene acceso
• get_space_messages(space_name: str, start_date: str, end_date: str = None) - Lista de mensajes de un espacio específico de Google Chat con filtrado de tiempo opcional

Desarrollo y depuración