Servidor Google Admin MCP

Un servidor FastMCP per gestionar usuaris de Google Workspace mitjançant l'API Admin Directory.

Funcionalitats

• Llista usuaris d'un domini
• Crea usuaris amb contrasenyes aleatòries segures
• Obté informació detallada dels usuaris
• Suspèn i reactiva usuaris

Requisits previos

• Docker
• Compte d'administrador de Google Workspace
• API Admin Directory activada
• Token OAuth2 codificat en Base64 a la variable d'entorn GOOGLE_TOKEN_JSON

Instal·lació

1. Clona el repositori
2. Construeix la imatge Docker:

docker build -t google-admin-mcp .

Execució del servidor

Executa el contenidor:

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

Eines disponibles

listUsers

Llista usuaris d'un domini.

{
  "domain": "yourdomain.com"
}

addUser

Crea un usuari nou amb contrasenya aleatòria segura.

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

getUser

Obtén informació detallada d'un usuari específic.

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

suspendUser

Suspèn un compte d'usuari.

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

unsuspendUser

Reactiva un compte d'usuari.

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

Notes de seguretat

• Tots els usuaris creats han de canviar la contrasenya en el primer inici de sessió
• Les contrasenyes es generen de forma segura amb:
  • Com a mínim 12 caràcters
  • Lletres majúscules i minúscules
  • Nombres
  • Caràcters especials
• El servidor requereix un token OAuth2 vàlid amb els escopos adequats de l'API Admin Directory

Gestió d'errors

El servidor proporciona missatges d'error clars per a:

• Fallades d'autenticació
• Paràmetres invàlids
• Errors de l'API
• Variables d'entorn mancants

Llicència

MIT License