Servidor Google Admin MCP

Un servidor FastMCP para la gestión de usuarios de Google Workspace a través de la API Admin Directory.

Funciones

• Lista de usuarios en un dominio
• Crear nuevos usuarios con contraseñas aleatorias seguras
• Obtener información detallada de los usuarios
• Suspender y anular la suspensión de usuarios

Requisitos previos

• Docker
• Cuenta de administrador de Google Workspace
• API de directorio de administración de Google habilitada
• Token OAuth2 codificado en Base64 en la variable de entorno GOOGLE_TOKEN_JSON

Instalación

1. Clonar el repositorio
2. Construye la imagen Docker:

docker build -t google-admin-mcp

Ejecutar el servidor

Ejecuta el contenedor:

docker run -e GOOGLE_TOKEN_JSON="your_base64_encoded_token" google-admin-mcp

Herramientas disponibles

listUsers

Lista los usuarios de un dominio.

{ "dominio": "sudominio.com" }

addUser

Crea un nuevo usuario con una contraseña aleatoria segura.

{ "primaryEmail": "user@yourdomain.com", "firstName": "First", "lastName": "Last" }

getUser

Obtiene información detallada sobre un usuario concreto.

{ "userKey": "user@yourdomain.com" }

suspendUser

Suspende una cuenta de usuario.

{ "userKey": "user@yourdomain.com" }

unsuspendUser

Desbloquea una cuenta de usuario.

{ "userKey": "user@yourdomain.com" }

Notas de seguridad

• Todos los usuarios creados deberán cambiar su contraseña en el primer acceso
• Las contraseñas se generan de forma segura con
  • Mínimo 12 caracteres
  • Letras mayúsculas y minúsculas
  • Números
  • Caracteres especiales
• El servidor requiere un token OAuth2 válido con los ámbitos adecuados de la API de Admin Directory

Gestión de errores

El servidor proporciona mensajes de error claros para:

• Fallos de autenticación
• Parámetros no válidos
• Errores de API
• Falta de variables de entorno

Licencia

Licencia MIT