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).

Related MCP server: Google Chat MCP Server

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)

python server.py -local-auth --port 8000

• 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)

{
    "mcpServers": {
        "google_chat": {
            "command": "uv",
            "args": [
                "--directory",
                "<YOUR_REPO_PATH>/google-chat-mcp-server",
                "run",
                "server.py",
                "--token-path",
                "<YOUR_REPO_PATH>/google-chat-mcp-server/token.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

fastmcp dev server.py --with-editable .